docs-latest.yml

name: Build and Deploy Documentation to Latest
env:
  DOCS_VERSION: latest

on:
  push:
    branches:
      - main

jobs:
  deploy-docs-latest:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v3

      - name: Build docs
        uses: C2SM/sphinx-action@sphinx-latest
        with:
          build-command: "sphinx-build -b html . _build"
          docs-folder: "docs/"

      - name: Deploy on GitHub Pages
        uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./docs/_build
          destination_dir: ${{ env.DOCS_VERSION }}
          allow_empty_commit: true