Skip to content
Merged
Changes from all commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
7b4fd19
docs: SEO titles for the 67 English pages whose title tag was two wor…
objectstack-fleet[bot] Oct 6, 2026
50f7841
Merge remote-tracking branch 'origin/main' into ff/issue-301
claude Oct 6, 2026
b421fbd
docs: muted-text and code-comment contrast, phone table affordance, F…
claude Oct 6, 2026
c5740f9
docs: record the measured search cold start and the smoke search requ…
claude Oct 6, 2026
21ef209
docs: state the measured contrast ratios in the theme and code-theme …
claude Oct 6, 2026
911a174
docs(views): declare views in a defineView container; list only the s…
claude Oct 6, 2026
c49dc6d
Merge remote-tracking branch 'origin/main' into ff/issue-311
claude Oct 6, 2026
5e666c3
fix(docs): run the awaited fumadocs-mdx write after next typegen in t…
claude Oct 6, 2026
5ad14ce
Merge remote-tracking branch 'origin/main' into ff/issue-305
claude Oct 6, 2026
41a1994
docs: localize fumadocs' accessible names, mark English page-tree ent…
claude Oct 6, 2026
c47c544
Merge remote-tracking branch 'origin/main' into ff/issue-307
claude Oct 6, 2026
69f7f1e
docs: make the views and flows code samples parse with @objectstack/s…
claude Oct 6, 2026
9709c50
Merge remote-tracking branch 'origin/main' into ff/issue-308
claude Oct 6, 2026
7c161c3
docs: a main landmark, a language switcher named by its text, a decor…
claude Oct 6, 2026
cc14430
ci: read the built pages for English chrome names and unmarked page-t…
claude Oct 6, 2026
77ad6ba
docs: the docs page's table-of-contents bar is not a second banner
claude Oct 6, 2026
5a07fbc
docs: the heading-anchor and code-copy buttons keep their own languag…
claude Oct 6, 2026
fa2390f
ci: the built-pages guard counts docs pages only
claude Oct 6, 2026
f8920d5
Merge remote-tracking branch 'origin/main' into ff/issue-312
claude Oct 6, 2026
482ff8f
docs: legal pages mark their English fallback lang="en" with the noti…
claude Oct 6, 2026
7c17974
docs: legal pages render an article inside HomeLayout's main, not a s…
claude Oct 6, 2026
0dd5019
Merge remote-tracking branch 'origin/main' into ff/issue-256-p3
claude Oct 7, 2026
e463447
docs(translation): delete siblings only when a correction reverses a …
claude Oct 6, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 8 additions & 4 deletions docs/TRANSLATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,11 @@ Three rules hold the model together:
matches its source is indistinguishable from one that does.
3. **A stale translation is worse than a missing one.** A missing translation
renders correct English — Fumadocs falls back automatically. A stale one
renders content the English source no longer claims. When in doubt, delete
rather than leave behind.
renders content the English source no longer claims. So an English
correction that removes or reverses a capability assertion deletes that
page's locale siblings in the same PR; wording and number drift (a port
number, a timing) stay with the translation pass
([ruling on #256](https://github.com/objectstack-ai/objectos/issues/256#issuecomment-5989567068)).

## Running a pass

Expand Down Expand Up @@ -193,8 +196,9 @@ Delete the English source and its locale siblings in the same PR. A translation
whose English source is gone is reported as **orphaned** and blocks the gate:
it can never be reached and can never be refreshed.

Never leave a translation behind for a page that was rewritten to say something
different. Deleting it is the correct action — English renders in its place.
Never leave a translation behind for a page that was rewritten to remove or
reverse a capability assertion (rule 3). Deleting it is the correct action —
English renders in its place.

## Derived locales

Expand Down
Loading