Merge pull request #2938 from hfr1tz3/extend_edges #6340

	name: Build Docs

	on:
	pull_request:
	push:
	branches: [main]
	tags:
	- '*'

	env:
	COMMIT_EMAIL: [email protected]
	MAKE_TARGET: -C python
	OWNER: tskit-dev
	REPO: tskit
	REQUIREMENTS: python/requirements/CI-docs/requirements.txt

	jobs:
	build-deploy-docs:
	name: Docs
	runs-on: ubuntu-latest
	defaults:
	run:
	shell: bash -l {0}
	steps:
	- name: Cancel Previous Runs
	uses: styfle/[email protected]
	with:
	access_token: ${{ github.token }}

	- uses: actions/checkout@v4

	- name: Setup Mambaforge
	uses: conda-incubator/setup-miniconda@v3
	with:
	miniforge-variant: Mambaforge
	miniforge-version: latest
	activate-environment: tskit-docs-env
	use-mamba: true

	- name: Cache Conda env
	uses: actions/cache@v4
	with:
	path: ${{ env.CONDA }}/envs
	key: conda-${{ runner.os }}--${{ runner.arch }}--${{ hashFiles(env.REQUIREMENTS) }}-${{ env.CACHE_NUMBER }}
	env:
	CACHE_NUMBER: 0
	id: cache

	- name: Update environment
	run: \|
	mamba install -y python=3.10 doxygen pip
	pip install -r ${{ env.REQUIREMENTS }}
	if: steps.cache.outputs.cache-hit != 'true'

	- name: Build C module
	if: env.MAKE_TARGET
	run: make $MAKE_TARGET

	- name: Build Docs
	run: make -C docs

	- name: Trigger docs site rebuild
	if: github.ref == 'refs/heads/main'
	run: \|
	curl -X POST https://api.github.com/repos/tskit-dev/tskit-site/dispatches \
	-H 'Accept: application/vnd.github.everest-preview+json' \
	-u AdminBot-tskit:${{ secrets.ADMINBOT_TOKEN }} \
	--data '{"event_type":"build-docs"}'

Provide feedback