Fix build suggestions #50679
Merged
Fix build suggestions #50679
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
gewarren requested review from a team, BillWagner and IEvangelist as code owners 
Contributor
There was a problem hiding this comment.
Pull request overview
This PR addresses build suggestions from issue #46535, applying standardization improvements across documentation files including metadata updates, writing style corrections, table formatting enhancements, and whitespace cleanup.
Key Changes
- Updated
ms.topicmetadata from "conceptual" to "article" across 40+ Orleans documentation files for consistency with documentation standards - Improved writing style by replacing "we recommend" with "it's best" to align with voice and tone guidelines that avoid first-person plural
- Enhanced Markdown table formatting across .NET Framework configuration schema documentation with improved alignment and consistent structure
- Removed obsolete metadata (ms.assetid GUIDs) and cleaned up trailing whitespace throughout
Reviewed changes
Copilot reviewed 55 out of 55 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| docs/standard/commandline/design-guidance.md | Updated ms.topic metadata and improved writing style to use "it's best" instead of "we recommend" |
| docs/orleans/streaming/*.md | Updated ms.topic metadata from "conceptual" to "article" across streaming documentation |
| docs/orleans/implementation/*.md | Updated ms.topic metadata across implementation documentation files |
| docs/orleans/host/*.md | Updated ms.topic metadata and removed trailing whitespace in client.md |
| docs/orleans/grains/**/*.md | Updated ms.topic metadata across grain documentation and subdirectories, removed trailing whitespace |
| docs/orleans/deployment/handling-failures.md | Updated ms.topic metadata |
| docs/framework/configure-apps/file-schema/*.md | Improved table formatting with better alignment, removed obsolete ms.assetid GUIDs, removed empty HTML anchor |
| docs/framework/configure-apps/file-schema/appsettings/*.md | Enhanced table formatting and removed obsolete ms.assetid metadata |
| docs/csharp/linq/standard-query-operators/join-operations.md | Simplified API documentation links and removed trailing whitespace |
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.
Contributes to #46535.
Internal previews
Toggle expand/collapse
<add>element for <appSettings><remove>element for<appSettings><clear>element for NameValueSectionHandler and DictionarySectionHandler<remove>element for NameValueSectionHandler and DictionarySectionHandler<sectionGroup>element for <configSections>Note
This table shows preview links for the 30 files with the most changes. For preview links for other files in this PR, select OpenPublishing.Build Details within checks.