Merge pull request #10 from lsst-dm/tickets/DM-44197 #44

	name: "Build Sphinx docs"
	"on":
	push:
	branches:
	- main
	paths:
	- 'docs/**'
	jobs:
	docs:
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@v4
	- uses: ammaraskar/sphinx-action@master
	with:
	docs-folder: "docs/"
	# Publish built docs to gh-pages branch.
	# ===============================
	- name: Commit documentation changes
	run: \|
	git clone https://${{ github.actor }}:${{ secrets.GITHUB_TOKEN }}@github.com/lsst-dm/uws-api-server.git --branch gh-pages --single-branch gh-pages
	cp -r docs/_build/html/* gh-pages/
	cp -r docs/api gh-pages/
	cd gh-pages
	touch .nojekyll
	git config --local user.email "[email protected]"
	git config --local user.name "GitHub Action"
	git add .
	git commit -m "Update documentation" -a \|\| true
	# The above command will fail if no changes were present, so we ignore that.
	- name: Push changes
	uses: ad-m/github-push-action@master
	with:
	branch: gh-pages
	directory: gh-pages
	github_token: ${{ secrets.GITHUB_TOKEN }}

Provide feedback