Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
10 changes: 5 additions & 5 deletions src/docs/Coding-Standards/Natural-Language.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
title: Natural Language
description: Which language each artifact is written in, and the plain-language writing rules for docs, issues, pull requests, comments, prompts, and agent-facing text — with US English as the project dialect.
description: Which language each artifact is written in, and the plain-language writing rules for docs, issues, pull requests, comments, prompts, and agent-facing text — with American English as the project dialect.
---

# Natural Language

Natural language is source code for humans and agents. It drives issues, pull requests, documentation, prompts, comments, error messages, release notes, and memory. Write it with the same care as code: clear, testable, consistent, and easy to change.

This standard defines which language each artifact is written in, and how English prose is written in the MSX ecosystem. The project dialect is **US English**.
This standard defines which language each artifact is written in, and how English prose is written in the MSX ecosystem. The project dialect is **American English (`en-US`)**.

## Write artifacts in English

Expand Down Expand Up @@ -37,9 +37,9 @@ The split is per artifact, not per repository. A repository that serves a Norweg

Repository artifacts are read by contributors, reviewers, and agents who do not share one first language, and by tooling built for English. Mixed-language automation splinters the vocabulary — `-Frakoblet` and `-Offline` are the same switch — and makes shared standards, linters, and scripts unreusable across repositories.

## Use US English
## Use American English

Use US spelling and vocabulary in all new and changed prose.
Use American spelling and vocabulary in all new and changed prose.

| Use | Avoid |
| --- | --- |
Expand Down Expand Up @@ -182,7 +182,7 @@ Prompts are requests, not guesses. A good prompt names the desired outcome, the
Prefer:

```text
Create a spec and design for org-scoped agent docs and memory in MSXOrg/docs. Follow the existing spec/design documentation model and use US English.
Create a spec and design for org-scoped agent docs and memory in MSXOrg/docs. Follow the existing spec/design documentation model and use American English.
```

Avoid:
Expand Down
2 changes: 1 addition & 1 deletion src/docs/Coding-Standards/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ The baseline pages apply to all code and come first; the per-language standards
| [Functions](Functions.md) | One responsibility, contracts in the signature, and validation at the boundary. |
| [Error Handling](Error-Handling.md) | Fail fast, never swallow, and write messages that help the next person. |
| [Documentation](Documentation.md) | Help that lives next to the code and explains the why. |
| [Natural Language](Natural-Language.md) | Which language each artifact is written in, and the plain-language writing rules for docs, issues, pull requests, comments, prompts, and agent-facing text — with US English as the project dialect. |
| [Natural Language](Natural-Language.md) | Which language each artifact is written in, and the plain-language writing rules for docs, issues, pull requests, comments, prompts, and agent-facing text — with American English as the project dialect. |
| [Testing](Testing.md) | The executable specification — test-first, locally runnable, deterministic. |
| [Performance](Performance.md) | Scale with the input, measure before optimizing, clarity first. |
| [Security](Security.md) | Least privilege, secret hygiene, and the OWASP baseline. |
Expand Down
Loading