Skip to content

📖 [Docs]: American English established as the project dialect - #178

Merged
Marius Storhaug (MariusStorhaug) merged 1 commit into
mainfrom
american-english-standard
Aug 15, 2026
Merged

📖 [Docs]: American English established as the project dialect#178
Marius Storhaug (MariusStorhaug) merged 1 commit into
mainfrom
american-english-standard

Conversation

@MariusStorhaug

@MariusStorhaug Marius Storhaug (MariusStorhaug) commented Aug 15, 2026

Copy link
Copy Markdown
Member

The natural-language standard now names American English as the MSX project dialect and identifies it with the en-US locale.

Changed: Project dialect terminology

Documentation authors and agents now see “American English” consistently in the standard, its generated index entry, and its prompt example. Existing spelling and vocabulary requirements remain unchanged.


Technical details
  • Updated src/docs/Coding-Standards/Natural-Language.md and regenerated src/docs/Coding-Standards/index.md.
  • Implementation plan progress: every task in Standardize natural language on American English #177 is complete.
  • Local validation: both documentation link checks pass, and all 95 Pester tests pass.
  • CI: lint, build, and both link checks pass. The test job is blocked before test execution because PSGallery is unavailable on the runner; Register PSGallery before installing Pester in CI #179 tracks that infrastructure defect.
  • Copilot review completed with no inline feedback.
Changed surface Standards checked Framework docs checked Result
src/docs/Coding-Standards/** Natural Language, Markdown Documentation Model Aligned
Relevant issues (or links)

Related work

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the Natural Language coding standard to explicitly name American English as the MSX project dialect and to identify it with the en-US locale, keeping the wording consistent across the standard and its generated index entry.

Changes:

  • Renamed “US English” terminology to “American English” in the Natural Language standard and its examples.
  • Added the explicit locale identifier en-US to the dialect statement.
  • Updated the generated Coding Standards index entry to match the new wording.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
src/docs/Coding-Standards/Natural-Language.md Replaces “US English” references with “American English” and adds en-US for clarity, including the prompt example.
src/docs/Coding-Standards/index.md Updates the generated index row description to match the Natural Language standard’s new dialect wording.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@MariusStorhaug
Marius Storhaug (MariusStorhaug) marked this pull request as draft August 15, 2026 14:06
@MariusStorhaug
Marius Storhaug (MariusStorhaug) marked this pull request as ready for review August 15, 2026 14:12
@MariusStorhaug
Marius Storhaug (MariusStorhaug) merged commit 413e535 into main Aug 15, 2026
26 of 27 checks passed
@MariusStorhaug
Marius Storhaug (MariusStorhaug) deleted the american-english-standard branch August 15, 2026 14:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

release:none No release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Standardize natural language on American English

2 participants