Help at hand
A person meeting SkyKeep for the first time should never have to go
looking for the manual. Beside every substantive control there is a
small link, and one click on it lands on the paragraph that explains
that control — not on the front page of the help, and not on the top of
a long page they then have to search.
The links are not written into the pages. Every one of them names a
topic, and a single registry inside the vault says where that topic
lives. That is what makes the promise keepable: a section of the manual
that is renamed or moved is one edit in one place, and a link that would
have gone nowhere fails the vault's own tests instead of quietly landing
a reader somewhere wrong.
Two things these links deliberately are not. They are not a signal about
what you may do: a help link is on the page whether or not the vault
would let you use the control beside it, so nobody can learn what exists
by reading which explanations are offered. And they are not a shortcut
into the vault: the manual holds no document, no compartment name and no
account, which is why it can be read by somebody who has not signed in
at all.
Every panel of the vault offers the way to its own explanation
- Given the pages the vault ships to a browser
- When a reader looks at each panel in turn
- Then every panel offers a link to its explanation
A help link lands on the paragraph, not on the top of the manual
- Given the pages the vault ships to a browser
- When a reader follows every help link on them
- Then each one arrives at a named section that really exists
Somebody who has not signed in can still read the explanations
- Given a visitor with no account and no session
- When they open every page of the manual
- Then the vault serves each one
A help link that names a topic the manual does not hold is refused
- Given a page whose help link names a topic the vault has never heard of
- When the vault serves that page
- Then no link is drawn at all
A panel added without a help link does not pass
- Given a page that has grown a new panel with no help link on it
- When the vault checks the pages for completeness
- Then the new panel is named as missing its explanation
A help link says nothing about what this vault holds
- Given the pages the vault ships to a browser
- When a reader reads the wording of every help link
- Then none of it names a document, a compartment or a count