[UUF] Prevent overlocalization of keywords in TOC #50822
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Contributor
There was a problem hiding this comment.
Pull request overview
This PR adds code-fencing (backticks) around keywords and commands in TOC (Table of Contents) files to prevent overlocalization during the translation process. The changes ensure that technical keywords remain in their original form and are not inadvertently translated.
Key Changes
- Added backticks around all
dotnetCLI commands in the tools and diagnostics navigation TOC - Added backticks around F# keywords (
let,do,open,nameof) in the F# language reference TOC - Added backticks around C# keywords and operators in the C# language reference TOC
- Updated headings in the
default.mdfile to use sentence case and backtick formatting consistently
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
| docs/navigate/tools-diagnostics/toc.yml | Added backticks around all dotnet CLI command names (105 changes) to prevent localization of command keywords |
| docs/fsharp/toc.yml | Added backticks around F# keywords (let, do, open, nameof) in 6 TOC entries |
| docs/csharp/language-reference/toc.yml | Added backticks around C# keywords, operators, and modifiers (108 changes) throughout the language reference navigation |
| docs/csharp/language-reference/operators/default.md | Updated headings to use sentence case and added backticks around default keyword references in section headings |
T-Gro
approved these changes
Dec 30, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Use code-fencing to prevent localization of keywords in TOC.Code-fencing only works for Markdown:
Instead, try no-loc in docfx.json for the toc.yml files.Currently the only workable solution for the TOC is to request that it be excluded from localization, which can't be done through this pull request.
Proceeding with smaller, related changes in this PR.
Internal previews