feat: enhance versions page with latest version highlighting and legend

brunoborges · brunoborges · commit ecd22ad600d7 · 2026-01-26T18:01:45.000-05:00
diff --git a/.github/templates/versions.html b/.github/templates/versions.html
@@ -43,6 +43,13 @@
     .version-list li:hover {
       background: #ebeef1;
     }
+    .version-list li.latest-version {
+      background: #d4edda;
+      border: 1px solid #28a745;
+    }
+    .version-list li.latest-version:hover {
+      background: #c3e6cb;
+    }
     .version-list a {
       color: #0366d6;
       text-decoration: none;
@@ -128,6 +135,38 @@
     .github-link svg {
       fill: white;
     }
+    .legend {
+      display: flex;
+      flex-wrap: wrap;
+      gap: 20px;
+      justify-content: center;
+      margin-top: 20px;
+      padding: 15px;
+      background: #f6f8fa;
+      border-radius: 6px;
+    }
+    .legend-item {
+      display: flex;
+      align-items: center;
+      gap: 8px;
+      font-size: 14px;
+      color: #586069;
+    }
+    .legend-color {
+      width: 16px;
+      height: 16px;
+      border-radius: 4px;
+    }
+    .legend-color.latest {
+      background: #d4edda;
+      border: 1px solid #28a745;
+    }
+    .legend-color.snapshot {
+      background: #ffc107;
+    }
+    .legend-color.archived {
+      background: #6c757d;
+    }
   </style>
 </head>
 <body>
@@ -155,6 +194,21 @@ <h2>Available Versions</h2>
       <!-- VERSION_LIST_PLACEHOLDER -->
     </ul>
     
+    <div class="legend">
+      <div class="legend-item">
+        <div class="legend-color latest"></div>
+        <span>Latest stable release</span>
+      </div>
+      <div class="legend-item">
+        <div class="legend-color snapshot"></div>
+        <span>Development snapshot</span>
+      </div>
+      <div class="legend-item">
+        <div class="legend-color archived"></div>
+        <span>Previous versions</span>
+      </div>
+    </div>
+    
     <div class="footer">
       <p>
         <a href="https://github.com/copilot-community-sdk/copilot-sdk-java">GitHub Repository</a> · 
diff --git a/.github/workflows/deploy-site.yml b/.github/workflows/deploy-site.yml
@@ -190,25 +190,25 @@ jobs:
           # Get versions from git tags (already sorted by version, descending)
           VERSIONS=$(git -C .. tag -l | grep -E '^v?[0-9]+\.[0-9]+' | sed 's/^v//' | sort -Vr)
           HAS_SNAPSHOT=$([ -d "snapshot" ] && echo "true" || echo "false")
-          HAS_LATEST=$([ -d "latest" ] && echo "true" || echo "false")
           
           # Generate version links
           VERSION_HTML=""
-          
-          # Add latest link if exists
-          if [ "$HAS_LATEST" = "true" ]; then
-            VERSION_HTML+='<li><a href="./latest/">Latest Release</a><span class="badge latest">latest</span></li>'
-          fi
+          IS_FIRST_VERSION="true"
           
           # Add snapshot if exists
           if [ "$HAS_SNAPSHOT" = "true" ]; then
             VERSION_HTML+='<li><a href="./snapshot/">Development (main branch)</a><span class="badge snapshot">snapshot</span></li>'
           fi
           
-          # Add versioned releases from tags
+          # Add versioned releases from tags (first one is latest)
           for v in $VERSIONS; do
             if [ -d "$v" ]; then
-              VERSION_HTML+="<li><a href=\"./$v/\">Version $v</a><span class=\"badge archived\">$v</span></li>"
+              if [ "$IS_FIRST_VERSION" = "true" ]; then
+                VERSION_HTML+="<li class=\"latest-version\"><a href=\"./$v/\">Version $v</a><span class=\"badge latest\">latest</span></li>"
+                IS_FIRST_VERSION="false"
+              else
+                VERSION_HTML+="<li><a href=\"./$v/\">Version $v</a><span class=\"badge archived\">$v</span></li>"
+              fi
             fi
           done
           
