Fix code fence issues in metrics and tracing documentation to prevent over-localization#47586
Fix code fence issues in metrics and tracing documentation to prevent over-localization#47586
Conversation
…ackticks Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
|
@copilot Are there any instrument names that should be surrounded with backticks? |
IEvangelist
left a comment
There was a problem hiding this comment.
For future reference @copilot, if a .NET version is listed, do not change it, as that can alter the meaning. For example, you in some places you changed .NET 8.8.0. to .NET 8.` which is misleading.
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
This PR fixes code fence issues in the .NET metrics and tracing documentation where type names and other technical terms were being over-localized in non-English versions of the documentation.
Problem
As reported in #43876, technical terms like
string,int,Boolean, and instrument type names were being translated/localized when the documentation was viewed in other languages, leading to confusing and incorrect translations. For example:Booleanwas over-localizedstringwas over-localizedSolution
Added code fences (backticks) around all type names in the "Type" column of attribute tables across the metrics documentation files. This prevents these technical terms from being localized while still allowing the descriptive text to be properly translated.
Files Changed
string, int →int)Example Change
Before:
After:
This ensures that
stringwon't be translated to local language equivalents while still allowing the description "The name being queried" to be properly localized.Fixes #43876.
💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.
Internal previews