Update project URLs for PyPI

Expand docs and harden Pages deployment

Add a .nojekyll marker for Pages deployments, update MkDocs site/repo config, significantly expand the existing docs pages, and enrich key docstrings for mkdocstrings output.