Skip to content

Docs: Sphinx on the shared documentation package - #45

Open
bdbarnett wants to merge 1 commit into
mainfrom
docs/sphinx-pygraphics
Open

bdbarnett wants to merge 1 commit into
mainfrom
docs/sphinx-pygraphics

Conversation

@bdbarnett

Copy link
Copy Markdown
Contributor

Moves the documentation from MkDocs Material to Sphinx, on the shared pydevices-docs package (PyDevices/.github, docs-config/, pinned to the docs-v0.1.0 tag): MyST Markdown, autodoc with Google-style docstrings, the shared top bar, and the live browser demos carried across as raw HTML.

A new Docs workflow builds the site with sphinx-build -W from the repository root, the way Read the Docs does (fail_on_warning: true). The edits to lib/ are docstrings only (a bare \n in three docstrings, a list without a blank line, a stray *).

Read the Docs builds the latest version from main, so the published site changes look when this merges.

MyST Markdown, autodoc with Google-style docstrings, the shared top bar and
theme, and the live demos carried across. A docs workflow builds the site with
sphinx-build -W, as Read the Docs does. Docstring-only edits so the reference
builds without warnings.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant