From f92f49fa3c8dc167e609735a7f0b6f09abad3bea Mon Sep 17 00:00:00 2001
From: Karl Skewes <karl.skewes@gmail.com>
Date: Tue, 12 Sep 2023 10:11:41 +1200
Subject: [PATCH] fix(changelog): Show most recent 3 major minor versions
 (#383)

---
 layouts/shortcodes/latest-stable.html | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/layouts/shortcodes/latest-stable.html b/layouts/shortcodes/latest-stable.html
index f773dc67..98920780 100644
--- a/layouts/shortcodes/latest-stable.html
+++ b/layouts/shortcodes/latest-stable.html
@@ -22,7 +22,17 @@
 {{ end }}
 {{ end }}
 
-{{ $latest_stables := first 3 (sort ($latest_major_minors).ByDate.Reverse) }}
+<!--
+Hugo doesn't have a semVer sort method so 1.9.0 appears "higher|later" than 1.30.0:
+1. sort by Date as a proxy for the latest versions, reverse order to have latest first
+2. take the first (latest) 6 versions. Arbitrary number, but if we release a patch
+   version that is 4 behind then the 6 *should* include semVer latest 3.
+   e.g 1.29.7 just released and newest by date, but 1.30.4, 1.31.2, 1.32.0 are
+   latest semVer 3.
+3. sort by Title which achieves semVer sort. Reverse so latest first.
+4. take the first 3.
+-->
+{{ $latest_stables := first 3 (sort (first 6 (sort ($latest_major_minors).ByDate.Reverse)).ByTitle.Reverse) }}
 
 <!-- print out our template section for each stable version -->
 {{ range sort ($latest_stables).ByTitle.Reverse }}