ObliviOS Developer portal Project site

Home / Decisions / ADR-130

Keep all documentation in one English style defined by docs/documentation-standard.md.

Accepted, recorded 4 October 2026.

Decision
ADR-130
Date
2026-10-04
Status
AcceptedAccepted

1Decision

Keep all documentation in one English style defined by docs/documentation-standard.md: one home per fact, records edited in place, no session records, transcripts or handoff prompts, no Dutch. Remove the existing session records, handoff prompts, the chronological status log and plans for completed work from the working tree. Close every session with the session-close skill and pass tools/docs/check-docs.py.

2Why and evidence

Records written per session, in mixed language and in changing structure, went stale because nothing owned a fact once it changed. A single home per fact plus an update-in-place rule and a mechanical gate keeps status.md, the router and the engineering notes current.

3Consequences

The removed files remain in git history. docs/product/status.md replaces the status log and the router's state narrative. docs/product/requirements.md is the former complete handoff. Designs and incident records that predate the standard are not yet in one structure.

4Review when

Revisit if the gate produces repeated false findings, or when the remaining designs and incident records are brought into one structure.

Read from docs/governance/decision-log.md, entry ADR-130.