Consider using Sphinx and GitHub Actions to publish a web version of the documentation to GitHub pages

[kevinputnam]

I was able to build and publish a rough but readable version of the docs by adding two files and making a small change to the README.md.

Result here: https://kevinputnam.github.io/x16-docs/README.html

Branch/Fork here with changes: https://github.com/kevinputnam/x16-docs/tree/sphinx-docs

Updated files:

• https://github.com/kevinputnam/x16-docs/blob/sphinx-docs/.github/workflows/publish.yml
• https://github.com/kevinputnam/x16-docs/blob/sphinx-docs/conf.py
• https://github.com/kevinputnam/x16-docs/blob/sphinx-docs/README.md

[tomxp411]

I think this is a good change, if the workflow also still produces a PDF file that can be included with the releases.

I'll ask @mooinglemur what he thinks. I hesitate to ask you to create a PR yet, but I do like the Github Pages layout for stuff like this.

[kevinputnam]

Yep. The pdf build script is still running. See here.

So, this would definitely be in addition. It isn't a zero work solution, as I did see some problems with some images not rendering and a few tables that were garbled.

[kevinputnam]

Made a quick update to fix chapters that have 1st level headers that were messing with the table of contents. I also made a small change to the publish script that should fix most of the broken images. See changes: https://kevinputnam.github.io/x16-docs/README.html