Update Docs Build and Publishing

[ghanse]

Issue

Documentation is currently broken. Content is embedded dynamically in the repo actions and is difficult to build and validate locally.

Proposed Change

Update the process to build and publish documentation. A few ideas:

1. Use something like pydoc-markdown to render the docs from markdown files
2. Add tooling to build and validate documentation locally
3. Update actions to build and deploy the docs