🔨[DEV] typing hints #37

	name: documentation
	on:
	push:
	branches:
	- master

	env:
	PYTHON_VERSION: 3.10.14

	permissions:
	contents: write
	id-token: write
	pages: write

	jobs:
	documentation:
	name: Build documentation
	runs-on: ubuntu-latest
	steps:

	- name: Checkout repository
	uses: actions/checkout@v4

	- name: Set up Python runtime
	uses: actions/setup-python@v5
	with:
	python-version: ${{ env.PYTHON_VERSION }}
	cache: pip
	cache-dependency-path: \|
	pyproject.toml
	requirements.txt

	- name: Set up build cache
	uses: actions/cache/restore@v4
	with:
	key: mkdocs-material-${{ hashfiles('.cache/**') }}
	path: .cache
	restore-keys: \|
	mkdocs-material-

	- name: Install Python dependencies
	run: \|
	pip install mkdocs-material
	pip install "mkdocstrings[python]"

	- name: Build documentation
	env:
	GH_TOKEN: ${{ secrets.GH_TOKEN }}
	run: \|
	mkdocs build --clean
	mkdocs --version

	- name: Adjust permissions
	run: \|
	chmod -c -R +rX site/ \| while read line; do
	echo "::warning title=Invalid file permissions automatically fixed::$line"
	done

	- name: Upload to GitHub Pages
	uses: actions/upload-pages-artifact@v3
	with:
	path: site

	- name: Deploy to GitHub Pages
	uses: actions/deploy-pages@v4

	- name: Save build cache
	uses: actions/cache/save@v4
	with:
	key: mkdocs-material-${{ hashfiles('.cache/**') }}
	path: .cache

Provide feedback