Sign in

Search issue titles and bodies, change requests and comments. Private repositories you cannot read are not included.

vole
Clone

Read only, no credentials:

https://rodent.software/git/vole.git

Write over SSH with a registered key:

git clone ssh://git@0.0.0.0:2222/vole.git

A free and open-source forge that lives in your Git repo.

Move UI copy rules from the UI plan into AGENTS.md

db5e4382af514e7ffcdcd3a578a1c41a03927dbf · Keenan Nemetz · 11d ago · parent 20d459f5

Move UI copy rules from the UI plan into AGENTS.md

The UI plan is winding down, but the copy rules need to keep applying.
Keep them in the agent instructions so every session reads them, and
drop the section from docs/ui-plan.md.

docs/ui-plan.md −23

@@ -36,29 +36,6 @@ deliberately rather than by drift.
36 36 limited to Home, Activity, search, and the account menu; the repository owns
37 37 its own horizontal tabs.
38 38
39 ## Copy
40
41 Interface text is part of the product. Write it for someone who uses the project
42 but does not know how it is built.
43
44 - A page subtitle says what the page is for, in one sentence a newcomer could
45 repeat. It describes the user's goal, not the schema or the Git operations
46 behind it.
47 - Use the reader's words: *proposed update*, *review*, *merge*, *saved version*.
48 Avoid *base branch*, *head commit*, *land*, *ref*, *metadata branch*, and other
49 internal names unless the page is specifically about that concept and there is
50 no shorter phrase.
51 - Name the outcome, not the mechanism. "Proposed updates, reviewed before they
52 are merged" beats "Branches proposed for a base branch, with review and
53 approvals before they land."
54 - Labels stay labels; sentences stay sentences. A button says *New change*, not
55 *Create a change request document*.
56 - Read it aloud before committing. If it sounds like a commit message, a schema
57 comment, or an API error, rewrite it for the person looking at the screen.
58
59 The web UI calls a change request a **Change**. The formal documents in this
60 directory can keep the longer name for the concept.
61
62 39 ## Navigation model
63 40
64 41 Global bar (slim): `vole` · `Home` · `Activity` · search · account menu. The