Separate latest/ and versions/ subdirectories for docs

.github/workflows/docs.yml

@@ -13,15 +13,15 @@ jobs:
   docs:
     runs-on: ubuntu-latest
     steps:
-      # Check out source
+      # Check out source.
       - uses: actions/checkout@v2
 
       - name: Set up Python
         uses: actions/setup-python@v1
         with:
           python-version: "3.10"
 
-      # Build documentation
+      # Build documentation.
       - name: Building documentation
         run: |
           pip install uv
@@ -30,20 +30,24 @@ jobs:
           sphinx-build docs/source docs/build -b dirhtml
 
       # Get version from pyproject.toml.
-      - name: Extract version
-        id: get_version
+      - name: Get version + subdirectory
         run: |
           VERSION=$(python -c "import toml; print(toml.load('pyproject.toml')['project']['version'])")
-          echo "version_subdir=versions/$VERSION" >> $GITHUB_OUTPUT
+          echo "DOCS_SUBDIR=versions/$VERSION" >> $GITHUB_ENV
+
+      # Get version from pyproject.toml.
+      - name: Override subdirectory to `latest/` for pushes
+        run: |
+          echo "DOCS_SUBDIR=latest" >> $GITHUB_ENV
+        if: github.event_name == 'push'
 
       # Deploy to version-dependent subdirectory.
       - name: Deploy to GitHub Pages
         uses: peaceiris/actions-gh-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: ./docs/build
-          # TODO: only set this to the version number for release actions.
-          destination_dir: ${{ steps.get_version.outputs.version_subdir }}
-          keep_files: false # This will only erase the destination subdirectory.
+          destination_dir: ${{ env.DOCS_SUBDIR }}
+          keep_files: false  # This will only erase the destination subdirectory.
           cname: viser.studio
         if: github.event_name != 'pull_request'