release documentation ordered by asset dates

#docs

fix cppalliance#802

Author: alandefreitas

docs/extensions/mrdocs-releases.js

@@ -89,6 +89,16 @@ function fetchWithRetry(url, headers) {
     }
 }
 
+function getReleaseDate(release) {
+    const dates = [
+        new Date(release.published_at),
+        new Date(release.created_at),
+        ...release.assets.map(asset => new Date(asset.created_at)),
+        ...release.assets.map(asset => new Date(asset.updated_at))
+    ];
+    return new Date(Math.max(...dates));
+}
+
 module.exports = function (registry) {
     registry.blockMacro('mrdocs-releases', function () {
         const self = this
@@ -118,9 +128,11 @@ module.exports = function (registry) {
             let text = '|===\n'
             text += '|          3+| 🪟 Windows                2+| 🐧 Linux                 \n'
             text += '| 📃 Release | 📦 7z   | 📦 msi  | 📦 zip  | 📦 tar.xz  | 📦 tar.gz  \n'
+            releases.sort((a, b) => getReleaseDate(b) - getReleaseDate(a));
             for (const release of releases) {
                 if (release.name === 'llvm-package') continue
-                text += `| ${release.html_url}[${release.name},window=_blank]\n\n${humanizeDate(release.published_at)} `
+                const date = getReleaseDate(release)
+                text += `| ${release.html_url}[${release.name},window=_blank]\n\n${humanizeDate(date)} `
                 const assetSuffixes = ['win64.7z', 'win64.msi', 'win64.zip', 'Linux.tar.xz', 'Linux.tar.gz']
                 for (const suffix of assetSuffixes) {
                     const asset = release.assets.find(asset => asset.name.endsWith(suffix))