index.md

Author: bclement-ocp

.github/workflows/documentation.yml

@@ -137,7 +137,7 @@ jobs:
 
       - name: Add files to bypass nojekyll
         run: |
-          touch _build/${{ needs.sphinx_docs.outputs.version-name }}/API/.nojekyll
+          touch _build/${{ needs.sphinx_docs.outputs.version-name }}/.nojekyll
 
       # Deploy files contain in _build directory on gh-pages branch
       - name: deploy-doc
@@ -167,19 +167,28 @@ jobs:
       - name: Write versions to JSON file
         run: |
           rm -f versions.json
-          echo '[' > versions.json
+          echo '[' >versions.json
           PREFIX=''
-          for version in $(ls -d */); do
-            echo -n "$PREFIX" >> versions.json
+          for version in $(ls -d */ | sort -n); do
+            echo -n "$PREFIX" >>versions.json
             PREFIX=','
-            echo -n '{"url": "/alt-ergo/'$version'", "slug": "'${version%/}'"}' >> versions.json
+            echo -n '{"url": "/alt-ergo/'$version'", "slug": "'${version%/}'"}' >>versions.json
+          done
+          echo -n ']' >>versions.json
+
+      - name: Write versions to index.md
+        run: |
+          rm -f index.md
+          echo '# Alt-Ergo' >index.md
+          echo 'Select the documentation for your version:' >>index.md
+          for version in $(ls -d */ | sort -n); do
+            echo " - [${version%/]($version)" >>index.md
           done
-          echo -n ']' >> versions.json
 
       - name: Push new versions
         run: |
           git config user.name github-actions
           git config user.email [email protected]
-          git add versions.json
+          git add versions.json index.md
           git commit -m 'Update versions.json' || exit 0
           git push