The vault documents its own tested behavior
The help pages are the vault's user manual, served from the vault
itself: guides for the portal, the admin console's settings, and the
agent tools — and one page per behavior suite, rendered word for word
from the same executable scenarios the vault is tested against. The
manual cannot promise what the tests do not hold, and a page that does
not exist is refused, never improvised.
The help index links every behavior suite
- Given a vault with behavior suites
- When a reader opens the help index
- Then every suite is linked as its own documentation page
A behavior page renders its scenarios word for word
- Given a vault with behavior suites
- When a reader opens one suite's page
- Then the suite's scenarios appear with their steps
Markup inside a suite is shown as text, never executed
- Given a behavior suite whose text contains markup
- When a reader opens that suite's page
- Then the markup is displayed harmlessly as text
A documentation page the vault does not have is refused
- Given a vault with behavior suites
- When a reader asks for a page that does not exist
- Then the vault answers not-found rather than inventing a page