About these docs
This site is built and deployed from the same repository as the product itself. It lives at docs.platypus.tickets, and it's reference documentation, not marketing. A few mechanics keep it honest:
- It documents current behaviour. Where the product has a quirk (say, what your subscription does and doesn't control), the docs say so rather than describing the system we'd like to have.
- API examples can't drift. Every JSON example in the API section is a fixture file asserted byte-for-byte by the Platypus test suite against real API responses. If the API changes, the tests fail until the examples are regenerated.
- Coverage is enforced. Each documented feature ties back to the capability specs that define Platypus. A new capability can't ship without either a docs page or an explicit, justified exemption. The docs build fails until one exists.
- Every build says what it documents. The footer (and
/build-info.json) carries the exact source commit these pages were built from. - AI tools can read it whole. The full content is published as
/llms.txtand/llms-full.txt.
Found something that doesn't match the product? That's a bug in the docs — email support@platypus.tickets.