Use the rate limits from the header to better control the waiting times #46

	name: Docs
	on: [push, pull_request, workflow_dispatch]
	permissions:
	contents: write
	jobs:
	docs:
	runs-on: ubuntu-latest
	steps:
	#----------------------------------------------
	# check-out repo and set-up python
	#----------------------------------------------
	- name: Check out repository
	uses: actions/checkout@v3
	- name: Set up python
	id: setup-python
	uses: actions/setup-python@v4
	with:
	python-version: '3.10'
	#----------------------------------------------
	# ----- install & configure poetry -----
	#----------------------------------------------
	- name: Install Poetry
	uses: snok/install-poetry@v1
	with:
	virtualenvs-create: false
	virtualenvs-in-project: false
	installer-parallel: true
	#----------------------------------------------
	# install dependencies if cache does not exist
	#----------------------------------------------
	- name: Install dependencies
	if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
	run: poetry install
	#----------------------------------------------
	# run sphinx build
	#----------------------------------------------
	- name: Sphinx build
	env:
	BEARER_TOKEN: test
	run: \|
	sphinx-build docs/source _build
	- name: Deploy
	uses: peaceiris/actions-gh-pages@v3
	if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}
	with:
	publish_branch: gh-pages
	github_token: ${{ secrets.GITHUB_TOKEN }}
	publish_dir: _build/
	force_orphan: true

Provide feedback