Documentation #1

	name: Documentation

	on:
	push:
	tags:
	- v*
	workflow_dispatch:

	permissions:
	contents: write # To push a branch
	pages: write # To push to Github Pages site
	id-token: write # To update deployment status

	jobs:
	build:
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@v4
	with:
	fetch-depth: 0

	# Install Rust & its package manager Cargo
	- name: Install cargo
	uses: actions-rs/toolchain@v1
	with:
	toolchain: stable
	profile: minimal

	# Cache installation assets
	- name: Cache cargo registry
	uses: actions/cache@v4
	with:
	path: ~/.cargo/registry
	key: ${{ runner.os }}-cargo-registry-${{ hashFiles('**/Cargo.lock') }}

	- name: Cache cargo index
	uses: actions/cache@v4
	with:
	path: ~/.cargo/git
	key: ${{ runner.os }}-cargo-index-${{ hashFiles('**/Cargo.lock') }}

	- name: Cache cargo build
	uses: actions/cache@v4
	with:
	path: target
	key: ${{ runner.os }}-cargo-build-target-${{ hashFiles('**/Cargo.lock') }}

	- name: Install mdbook and preprocessors
	uses: actions-rs/cargo@v1
	with:
	command: install
	args: mdbook mdbook-alerts

	- name: Setup Pages
	uses: actions/configure-pages@v5
	- name: Build Book
	run: \|
	mdbook build ./docs
	touch ./docs/book/.nojekyll

	- name: Upload artifact
	uses: actions/upload-pages-artifact@v3
	with:
	# Upload entire repository
	path: ./docs/book


	deploy:
	environment:
	name: github-pages
	url: ${{ steps.deployment.outputs.page_url }}
	runs-on: ubuntu-latest
	needs: build
	steps:
	- name: Deploy to GitHub Pages
	id: deployment
	uses: actions/deploy-pages@v4

Provide feedback