Mark the highest version as 'main'

Author: holly-cummins

_plugins/version_permalink.rb

@@ -19,20 +19,28 @@ def generate(site)
 
       number_pattern = /^[0-9.]+$/
 
+      j = 0
+      # Add a marker for things that don't have a version, because liquid filters are not as flexible as we'd like
+      # This has to happen before we do any conversion of 'main'
+      collection.docs.filter { |doc| ! doc.data["version"].match?(number_pattern) }.each { |doc|
+        data = doc.data
+        j +=1
+        data.merge!('unversion_counter' => j)
+      }
+
       # Also add a version scalar that we can use for sorting
       i = 0
       collection.docs.filter { |doc| doc.data["version"].match?(number_pattern) }.sort_by { |doc| Gem::Version.new(doc.data["version"]) }.reverse.each { |doc|
         data = doc.data
         i +=1
         data.merge!('version_counter' => i)
-      }
 
-      j = 0
-      # Add a marker for things that don't have a version, because liquid filters are not as flexible as we'd like
-      collection.docs.filter { |doc| ! doc.data["version"].match?(number_pattern) }.each { |doc|
-        data = doc.data
-        j +=1
-        data.merge!('unversion_counter' => j)
+
+        # Mark the latest release as main
+        if i == 1
+          data.merge!('proposed_version' => data["version"])
+          data.merge!('version' => "main")
+        end
       }
 
     end

migration-guides.html

@@ -4,16 +4,19 @@
 
 <h1>Migration Guides</h1>
 
-
-
 {% assign doclist = site.migrations | sort: 'version_counter' | where: 'unversion_counter', nil  %}
 <ul>
     {% for doc in doclist %}
-    <li><a href="{{ site.baseurl }}{{ doc.url }}">{{ doc.version }}</a></li>
+    {% if doc.proposed_version %}
+    {% assign comment = ', will be ' | append: doc.proposed_version %}
+    {% else %}
+    {% assign comment = '' %}
+    {% endif %}
+    <li><a href="{{ site.baseurl }}{{ doc.url }}">{{ doc.version }}</a>{{ comment }}</li>
     {% endfor %}
 </ul>
 
-{% assign doclist = site.migrations | sort: 'version_counter' | where: 'version_counter', nil  %}
+{% assign doclist = site.migrations | sort: 'version_counter' | where: 'version_counter', nil | where_exp: 'doc', "doc.version != 'Migration-Guides'" %}
 <h2>Special Guides</h2>
 <ul>
     {% for doc in doclist %}