Merge pull request #487 from oscar-system/bl/pidlock #547

	name: Create documentation

	on:
	push:
	branches:
	- master
	tags: '*'
	pull_request:
	workflow_dispatch:

	# needed to allow julia-actions/cache to delete old caches that it has created
	permissions:
	actions: write

	concurrency:
	# group by workflow and ref; the last slightly strange component ensures that for pull
	# requests, we limit to 1 concurrent job, but for the master branch we don't
	group: ${{ github.workflow }}-${{ github.ref }}-${{ github.ref != 'refs/heads/master' \|\| github.run_number }}
	# Cancel intermediate builds, but only if it is a pull request build.
	cancel-in-progress: ${{ startsWith(github.ref, 'refs/pull/') }}

	jobs:
	create-documentation:
	runs-on: ubuntu-latest

	steps:
	- uses: actions/checkout@v4
	- name: "Set up Julia"
	uses: julia-actions/setup-julia@v2
	with:
	version: '1.10'
	- uses: julia-actions/cache@v1
	- name: "Add Documenter package"
	run: julia --project=docs/ -e 'using Pkg; Pkg.develop(PackageSpec(path=pwd()));
	Pkg.instantiate()'
	- name: "Build and deploy documentation"
	env:
	GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
	DOCUMENTER_KEY: ${{ secrets.DOCUMENTER_KEY }} # For authentication with SSH deploy key
	run: julia --project=docs/ docs/make.jl

Provide feedback