build_site.yml

name: Publish docs via GitHub Pages
on:
  push:
    branches:
      - main


jobs:
  build:
    name: Deploy docs
    runs-on: ubuntu-latest
    if: github.event_name == 'release' && github.event.action == 'published'
    steps:
      - name: Checkout main
        uses: actions/checkout@v2

      - name: Build wheels
        shell: bash -l {0}
        run: |
          bash docs/create_docs.sh

      # NOT SURE HOW TO AUTOMATE VERSIONING, RUNNING THIS WILL WIPE EVERYTHING
      # - name: Deploy docs
      #   uses: mhausenblas/mkdocs-deploy-gh-pages@master
      #   # Or use mhausenblas/mkdocs-deploy-gh-pages@nomaterial to build without the mkdocs-material theme
      #   env:
      #     GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
      #     # CUSTOM_DOMAIN: optionaldomain.com
      #     CONFIG_FILE: mkdocs.yml
      #     # EXTRA_PACKAGES: mkdocstrings
      #     # GITHUB_DOMAIN: github.myenterprise.com
      #     REQUIREMENTS: docs/requirements.txt