Share a Sphinx build
make html produces a directory. Directories are the least shareable unit in
software: you cannot paste one into Slack, you cannot attach one to a ticket,
and zipping it produces the email that ends with "just clone the repo and
build it yourself" — which nobody does, so the docs ship unreviewed.
The usual fix is to deploy a preview. That works if you already have preview infrastructure and the reviewer is an engineer. It does not work for the technical writer, the support lead, or the customer you promised a look at the migration guide.
Publish the build
sphinx-build -b html docs docs/_build/html
Then drag docs/_build/html onto Comma. The folder upload picks index.html
as the entry, uploads the rest of the tree as assets, and rewrites relative
src / href references so the build renders as itself — theme CSS, search
box, images, and the links from one page to the next.
To do it from CI instead, zip the build and publish the archive the same way you would any bundle; see publishing from CI and the API reference.