name: Deploy Docs

on:

push:

branches:

- develop

paths:

- 'docs/**'

- 'mkdocs.yml'

- '.github/workflows/docs.yml'

workflow_dispatch:

permissions:

contents: read

pages: write

id-token: write

concurrency:

group: pages

cancel-in-progress: false

jobs:

build:

name: Build MkDocs

runs-on: ubuntu-latest

steps:

- uses: actions/checkout@v4

- uses: actions/setup-python@v5

with:

python-version: 3.x

- name: Install dependencies

run: pip install mkdocs-material

- name: Build docs

run: mkdocs build --strict

- name: Configure Pages

uses: actions/configure-pages@v5

- name: Upload Pages artifact

uses: actions/upload-pages-artifact@v3

with:

path: site

deploy:

name: Deploy to GitHub Pages

needs: build

runs-on: ubuntu-latest

environment:

name: github-pages

url: ${{ steps.deployment.outputs.page_url }}

steps:

- name: Deploy Pages artifact

id: deployment

uses: actions/deploy-pages@v4