docs

Documentation

Overview

Command docs builds the Conductor documentation in docs/slashdocs into self-contained HTML pages, and publishes them to a slashdocs server.

go run ./scripts/docs build                  # writes docs/slashdocs/dist/*.html
go run ./scripts/docs publish                # creates or updates each page in slashdocs
go run ./scripts/docs publish -m "Explain fencing"

Publishing uses the slashdocs CLI (logged in with `slashdocs auth login`). The first publish creates one document per page; later ones push a new version of each page whose HTML changed. Links between pages point at their slashdocs documents. What was published where is kept in docs/slashdocs/published.json (per server; not committed).