Add an example of calculating the map positions #2283

	name: Docs

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

	env:
	BUILD_GSL: true
	COMMIT_EMAIL: [email protected]
	MAKE_TARGET: cmodule
	OWNER: tskit-dev
	REPO: msprime

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

	- uses: actions/checkout@v3
	with:
	submodules: true

	- uses: actions/setup-python@v4
	with:
	python-version: "3.11"
	cache: "pip"

	- name: Create venv and install deps (one by one to avoid conflict errors)
	run: \|
	pip install --upgrade pip wheel
	pip install -r requirements/CI-docs/requirements.txt

	- name: Install GSL
	if: env.BUILD_GSL == 'true'
	run: sudo apt-get install -y libgsl0-dev

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

	- name: Build Docs
	run: \|
	cd docs
	make

	- 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