Skip to content

Conversation

@gewarren
Copy link
Contributor

@gewarren gewarren commented Nov 28, 2025

Contributes to #50193.


Internal previews

Toggle expand/collapse
📄 File 🔗 Preview link
docs/framework/tools/al-exe-assembly-linker.md Al.exe (Assembly Linker)
docs/framework/tools/caspol-exe-code-access-security-policy-tool.md Caspol.exe (Code Access Security Policy Tool)
docs/framework/tools/ilasm-exe-il-assembler.md "Ilasm.exe (IL Assembler)"
docs/framework/tools/ildasm-exe-il-disassembler.md Ildasm.exe (IL Disassembler)
docs/framework/tools/index.md docs/framework/tools/index
docs/framework/tools/mage-exe-manifest-generation-and-editing-tool.md Mage.exe (Manifest Generation and Editing Tool)
docs/framework/tools/mdbg-exe.md "MDbg.exe (.NET Framework Command-Line Debugger)"
docs/framework/tools/mgmtclassgen-exe.md Mgmtclassgen.exe (Management Strongly Typed Class Generator)
docs/framework/tools/tlbexp-exe-type-library-exporter.md docs/framework/tools/tlbexp-exe-type-library-exporter
docs/framework/tools/tlbimp-exe-type-library-importer.md Tlbimp.exe (Type Library Importer)
docs/framework/tools/winres-exe-windows-forms-resource-editor.md "Winres.exe (Windows Resource Localization Editor)"
docs/framework/unmanaged-api/authenticode/axlrsakeyvaluetopublickeytoken-function.md _AxlRSAKeyValueToPublicKeyToken function
docs/framework/unmanaged-api/diagnostics/isymunmanagedasyncmethodpropertieswriter-definecatchhandleriloffset-method.md "ISymUnmanagedAsyncMethodPropertiesWriter::DefineCatchHandlerILOffset Method"
docs/framework/unmanaged-api/diagnostics/isymunmanagedasyncmethodpropertieswriter-interface.md ISymUnmanagedAsyncMethodPropertiesWriter Interface
docs/framework/unmanaged-api/hosting/iclrappdomainresourcemonitor-interface.md ICLRAppDomainResourceMonitor Interface
docs/framework/unmanaged-api/hosting/iclrmetahost-interface.md docs/framework/unmanaged-api/hosting/iclrmetahost-interface
docs/framework/unmanaged-api/hosting/iclrmetahost-querylegacyv2runtimebinding-method.md ICLRMetaHost::QueryLegacyV2RuntimeBinding Method
docs/framework/unmanaged-api/hosting/iclrruntimeinfo-bindaslegacyv2runtime-method.md "ICLRRuntimeInfo::BindAsLegacyV2Runtime Method"
docs/framework/unmanaged-api/hosting/metahost-config-flags-enumeration.md METAHOST_CONFIG_FLAGS Enumeration
docs/framework/unmanaged-api/hosting/startup-flags-enumeration.md docs/framework/unmanaged-api/hosting/startup-flags-enumeration
docs/framework/unmanaged-api/wmi/putinstancewmi.md PutInstanceWmi function
docs/framework/unmanaged-api/wmi/putmethod.md PutMethod function (Unmanaged API Reference)
docs/framework/unmanaged-api/wmi/qualifierset-put.md QualifierSet_Put function
docs/framework/wcf/diagnostics/etw/216-messagesentbytransport.md "216 - MessageSentByTransport"
docs/framework/wcf/how-to-specify-client-credential-values.md How to: Specify Client Credential Values
docs/framework/whats-new/index.md docs/framework/whats-new/index
docs/framework/whats-new/whats-new-in-accessibility.md What's new in accessibility in .NET Framework
docs/framework/whats-new/whats-obsolete.md What's obsolete in .NET Framework
@gewarren gewarren requested a review from a team as a code owner November 28, 2025 18:09
Copilot AI review requested due to automatic review settings November 28, 2025 18:09
@dotnetrepoman dotnetrepoman bot added this to the November 2025 milestone Nov 28, 2025
Copilot finished reviewing on behalf of gewarren November 28, 2025 18:11
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR prevents certain content from being localized by converting formatting patterns. The changes systematically convert property names, technical identifiers, and XML tag references from bold formatting or escaped markup to code-formatted backticks (`), and remove trailing spaces from YAML frontmatter.

Key Changes:

  • Property/identifier names: Changed from **PropertyName** to `PropertyName` (e.g., LiveSetting, Key, ID)
  • XML tag references: Changed from \<tagName> to `<tagName>` (e.g., <supportedRuntime>, <startup>)
  • YAML frontmatter: Removed trailing spaces from metadata fields like helpviewer_keywords:, api_name:, etc.

Reviewed changes

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

Show a summary per file
File Description
docs/framework/whats-new/whats-obsolete.md Removed trailing space in YAML; converted XML tag reference to code format
docs/framework/whats-new/whats-new-in-accessibility.md Converted property names (LiveSetting, LiveRegionChanged) to code format
docs/framework/whats-new/index.md Converted interface/property names and XML tags to code format
docs/framework/wcf/how-to-specify-client-credential-values.md Converted attribute names (mode, clientCredentialType) to code format
docs/framework/wcf/diagnostics/etw/216-messagesentbytransport.md Converted event name to code format; cleaned up formatting
docs/framework/unmanaged-api/wmi/qualifierset-put.md Converted qualifier name (Key) to code format
docs/framework/unmanaged-api/wmi/putmethod.md Removed trailing spaces; converted qualifier names (ID) to code format
docs/framework/unmanaged-api/wmi/putinstancewmi.md Converted flavor/qualifier names to code format
docs/framework/unmanaged-api/hosting/startup-flags-enumeration.md Removed trailing spaces; converted XML tag references to code format
docs/framework/unmanaged-api/hosting/metahost-config-flags-enumeration.md Removed trailing spaces; converted XML tag references to code format
docs/framework/unmanaged-api/hosting/iclrruntimeinfo-bindaslegacyv2runtime-method.md Removed trailing spaces; converted XML tag references to code format
docs/framework/unmanaged-api/hosting/iclrmetahost-querylegacyv2runtimebinding-method.md Removed trailing spaces; converted XML tag references to code format
docs/framework/unmanaged-api/hosting/iclrmetahost-interface.md Removed trailing spaces; converted XML tag references to code format
docs/framework/unmanaged-api/hosting/iclrappdomainresourcemonitor-interface.md Removed trailing spaces; converted XML tag references to code format
docs/framework/unmanaged-api/diagnostics/isymunmanagedasyncmethodpropertieswriter-interface.md Converted event name (CatchHandlerFound) to code format
docs/framework/unmanaged-api/diagnostics/isymunmanagedasyncmethodpropertieswriter-definecatchhandleriloffset-method.md Converted event name to code format
docs/framework/unmanaged-api/authenticode/axlrsakeyvaluetopublickeytoken-function.md Converted XML element names to code format
docs/framework/tools/winres-exe-windows-forms-resource-editor.md Converted window/property names to code format
docs/framework/tools/tlbimp-exe-type-library-importer.md Removed trailing spaces; converted parameter values to code format
docs/framework/tools/tlbexp-exe-type-library-exporter.md Removed trailing spaces; converted option names to code format
docs/framework/tools/mgmtclassgen-exe.md Removed trailing spaces; converted parameter values and qualifiers to code format
docs/framework/tools/mdbg-exe.md Converted command names to code format for consistency
docs/framework/tools/mage-exe-manifest-generation-and-editing-tool.md Converted XML element names to code format
docs/framework/tools/index.md Removed trailing spaces; converted XML tag references to code format
docs/framework/tools/ildasm-exe-il-disassembler.md Removed trailing spaces; converted parameter values to code format
docs/framework/tools/ilasm-exe-il-assembler.md Removed trailing spaces; converted option values to code format
docs/framework/tools/caspol-exe-code-access-security-policy-tool.md Converted XML tag references to code format
docs/framework/tools/al-exe-assembly-linker.md Converted Win32 resource field names to code format

You can also share your feedback on Copilot code review for a chance to win a $100 gift card. Take the survey.

|**/forward**|Uses forward class declaration.|
|**/headers**|Includes file header information in the output.|
|**/item:** `class`[**::** `member`[`(sig`]]|Disassembles the following depending upon the argument supplied:<br /><br /> - Disassembles the specified `class`.<br />- Disassembles the specified `member` of the `class`.<br />- Disassembles the `member` of the `class` with the specified signature `sig`. The format of `sig` is:<br /> [`instance`] `returnType`(`parameterType1`, `parameterType2`, …, `parameterTypeN`)<br /> **Note** In the .NET Framework versions 1.0 and 1.1, `sig` must be followed by a closing parenthesis: `(sig)`. Starting with the Net Framework 2.0 the closing parenthesis must be omitted: `(sig`.|
|**/item:** `class`[**::** `member`[`(sig`]]|Disassembles the following depending upon the argument supplied:<br /><br /> - Disassembles the specified `class`.<br />- Disassembles the specified `member` of the `class`.<br />- Disassembles the `member` of the `class` with the specified signature `sig`. The format of `sig` is:<br /> [`instance`] `returnType`(`parameterType1`, `parameterType2`, …, `parameterTypeN`)<br /> `Note` In the .NET Framework versions 1.0 and 1.1, `sig` must be followed by a closing parenthesis: `(sig)`. Starting with the Net Framework 2.0 the closing parenthesis must be omitted: `(sig`.|
Copy link

Copilot AI Nov 28, 2025

Choose a reason for hiding this comment

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

The word "Note" should not be formatted with backticks in this context. Per the Markdown style guidelines, only use code formatting for file names, folders, custom types, and non-localizable text. "Note" is a standard English word introducing a note section, not a technical term.

Copilot uses AI. Check for mistakes.
```

In the previous example, there could be several methods named `MyMethod` with different signatures. The following command disassembles the instance method `MyMethod` with the return type of **void** and the parameter types **int32** and **string**.
In the previous example, there could be several methods named `MyMethod` with different signatures. The following command disassembles the instance method `MyMethod` with the return type of `void` and the parameter types **int32** and **string**.
Copy link

Copilot AI Nov 28, 2025

Choose a reason for hiding this comment

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

The word "void" should be formatted as void (with backticks) to be consistent with how return types are formatted elsewhere in documentation. In line 163, "void" is a technical type keyword that should use code formatting.

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment