docs: standardize repository language on English

This commit is contained in:
fy59 2026-09-02 12:53:23 +02:00
parent b23241eab2
commit d0329bc3db
2 changed files with 47 additions and 0 deletions

View file

@ -23,6 +23,36 @@
Resolve locally determinable engineering problems from the existing code and Resolve locally determinable engineering problems from the existing code and
canonical documentation. canonical documentation.
## Repository language policy
The canonical language of the Lardon3D repository is English.
This applies to:
- README.md;
- AGENTS.md;
- all current and future files under docs/**;
- prompt.md and all files under prompt/**;
- source comments under include/lardon3d/** and src/**;
- developer-facing technical documentation, diagnostics and engineering contracts where applicable.
The repository must not intentionally mix French and English technical prose.
Existing French documentation and source comments are to be converted to English during the planned documentation and source-comment remediation passes, without changing scientific meaning, FROZEN facts, historical evidence, numeric values, identities, lifecycle truth or contract authority.
Historical documents may be translated, but translation must not modernize or reinterpret the historical state they record.
User-interface language is a separate product concern. Existing TUI labels may remain in their current language until an explicit localization/product decision is made. Repository language policy does not require the UI to be English-only.
Canonical markers:
DOCUMENTATION_LANGUAGE=ENGLISH
SOURCE_COMMENT_LANGUAGE=ENGLISH
AGENT_CONTRACT_LANGUAGE=ENGLISH
USER_INTERFACE_LANGUAGE=INDEPENDENT
## 2. FROZEN integrity ## 2. FROZEN integrity
The following current project foundation is protected and may change only The following current project foundation is protected and may change only

View file

@ -414,6 +414,23 @@ docs/architecture/task_kind_registry.md states sixteen kinds but points to a Res
The heading and cross-link must be synchronized without altering historical fourteen-kind audit evidence. The heading and cross-link must be synchronized without altering historical fourteen-kind audit evidence.
# Repository language decision
Human authority has selected English as the canonical repository language.
The final repository target is:
- DOCUMENTATION_LANGUAGE=ENGLISH
- SOURCE_COMMENT_LANGUAGE=ENGLISH
- AGENT_CONTRACT_LANGUAGE=ENGLISH
- USER_INTERFACE_LANGUAGE=INDEPENDENT
All technical documentation, agent contracts, prompt files and production source comments are to converge on English during the remediation passes.
Translation must preserve scientific meaning, historical truth, FROZEN contracts, identities, numeric values, lifecycle state and evidence. A historical document may be translated but must not be silently modernized.
The TUI language is a separate product/localization decision and is not changed by this documentation-language decision.
# Product documentation intentionally deferred # Product documentation intentionally deferred
This documentation cleanup must not invent final contracts for: This documentation cleanup must not invent final contracts for: