General docs improvements #198

	name: Documentation

	permissions:
	contents: write # Required when authenticating with `GITHUB_TOKEN`, not needed when authenticating with SSH deploy keys
	pull-requests: read # Required when using `push_preview=true`
	statuses: write # Optional, used to report documentation build statuses

	on:
	push:
	branches:
	- main
	pull_request:
	branches:
	- main

	concurrency:
	# Skip intermediate builds: always.
	# Cancel intermediate builds: only if it is a pull request build.
	group: ${{ github.workflow }}-${{ github.ref }}
	cancel-in-progress: ${{ startsWith(github.ref, 'refs/pull/') }}


	jobs:
	build:
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@v4
	- uses: julia-actions/setup-julia@v2
	with:
	version: '1.10'
	- uses: julia-actions/cache@v2
	- name: Install Dependencies
	run: \|
	julia --project=./docs -e '
	using Pkg
	Pkg.develop(PackageSpec(path=pwd()))
	Pkg.instantiate()'
	- name: Build and Deploy
	run: julia -t 2 --project=./docs ./docs/make.jl
	env:
	GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # If authenticating with GitHub Actions token
	DOCUMENTER_KEY: ${{ secrets.DOCUMENTER_KEY }} # If authenticating with SSH deploy key

Provide feedback