docs.yml

name: Docs

on:
  workflow_dispatch:
  push:
    branches:
      - master
    paths:
      - 'docs/**'
      - 'mkdocs.yml'

jobs:
  lint:
    name: MkDocs Deploy
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v2
      - name: Setup Python
        uses: actions/setup-python@v2
        with:
          python-version: 3.9
      - name: Setup Poetry
        uses: abatilo/actions-poetry@v2.0.0
      - name: Poetry - Cache
        id: poetry-cache
        uses: actions/cache@v2
        with:
          path: ~/.cache/pypoetry/virtualenvs
          key: ${{ runner.os }}-poetry-${{ hashFiles('poetry.lock') }}
      - name: Poetry - Install
        if: steps.poetry-cache.outputs.cache-hit != 'true'
        run: poetry install
      - name: Poetry - mkdocs deploy
        run: poetry run mkdocs gh-deploy --force