documentation.yml

name: Build & Deploy MkDocs
on:
  push:
    branches:
      - main
    workflow_dispatch:

jobs:
  documentation:
    name: Build documentation
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v2
        
      - name: Set up Python runtime
        uses: actions/setup-python@v2
        with:
          python-version: 3.x
          
      - name: Install Insiders build
        if: github.event.repository.fork == false
        env:
          GH_TOKEN: ${{ secrets.GH_TOKEN }}
        run: pip install git+https://${GH_TOKEN}@github.com/squidfunk/mkdocs-material-insiders.git        
        
      - name: Deploy documentation
        run: mkdocs gh-deploy --force