Add sphinx read the docs, organizational docs #15

	name: Build and Deploy docs

	on:
	push:
	branches: [ main ]
	pull_request:
	branches: [ main ]
	release:
	types:
	- created

	jobs:
	docs:
	name: build and deploy docs
	runs-on: ubuntu-latest

	steps:
	- name: Checkout code
	uses: actions/checkout@v2
	with:
	fetch-depth: 0
	- name: Set system to non-interactive mode
	run: export DEBIAN_FRONTEND=noninteractive
	- name: install dependencies
	run: \|
	pip install sphinx
	pip install sphinx-sitemap
	pip install sphinx-rtd-theme
	pip install sphinx-multiversion
	pip install sphinx-copybutton
	- name: build docs
	run: \|
	echo "Repo = ${GITHUB_REPOSITORY}"
	cd doc/sphinx
	# throw warnings as error to make sure docs properly build
	make multiversion SPHINXOPTS="-W --keep-going -n"
	- name: Deploy
	if: ${{ (github.event.pull_request.head.repo.full_name == github.repository) \|\| (github.ref == 'refs/heads/main') }}
	uses: peaceiris/[email protected]
	with:
	github_token: ${{ secrets.GITHUB_TOKEN }}
	publish_dir: ./doc/sphinx/_build/html
	force_orphan: true

Provide feedback