Fix up list indentation#12758
Open
gewarren wants to merge 4 commits into
Open
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
This PR primarily cleans up Markdown/list indentation and related whitespace in the ECMA XML docs, improving consistency of rendered lists, tables, and code blocks across many API reference pages.
Changes:
- Normalized list indentation and continuation lines in
<format type="text/markdown">blocks. - Adjusted formatting for code fences, snippet directives, and Markdown tables to align with consistent indentation.
- Included a few incidental text/layout edits mixed in with the whitespace changes (some of which introduce minor typos/formatting regressions noted in review comments).
Reviewed changes
Copilot reviewed 22 out of 69 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| xml/System/TypeInitializationException.xml | Adjusted indentation around an IL code fence inside remarks. |
| xml/System/Type.xml | Normalized indentation for list items and snippet directives in remarks. |
| xml/System/Tuple`7.xml | Fixed indentation for snippet directives under list items. |
| xml/System/Tuple`6.xml | Fixed indentation for snippet directives under list items. |
| xml/System/Tuple`5.xml | Fixed indentation for snippet directives under list items. |
| xml/System/Tuple`4.xml | Fixed indentation for snippet directives under list items. |
| xml/System/Tuple`3.xml | Fixed indentation for snippet directives under list items. |
| xml/System/Tuple`2.xml | Fixed indentation for snippet directives under list items. |
| xml/System/TimeSpan.xml | Normalized indentation for a continuation paragraph under a list section. |
| xml/System/String.xml | Normalized indentation for a Markdown table and snippet directives. |
| xml/System/OverflowException.xml | Normalized indentation for snippet directives under bullet items. |
| xml/System/OutOfMemoryException.xml | Normalized indentation for a paragraph and snippet directives under a bullet item. |
| xml/System/ObjectDisposedException.xml | Normalized indentation for snippet directives under a bullet item. |
| xml/System/Object.xml | Normalized indentation for snippet directives and continuation paragraphs in remarks. |
| xml/System/NullReferenceException.xml | Normalized indentation throughout a large list of causes and snippets. |
| xml/System/InvalidOperationException.xml | Normalized indentation for multi-language code fences. |
| xml/System/IntPtr.xml | Normalized indentation for continuation paragraphs in a numbered list. |
| xml/System/IndexOutOfRangeException.xml | Normalized indentation for snippet directives, nested lists, code fences, and callouts. |
| xml/System/IEquatable`1.xml | Normalized indentation for nested bullet list items. |
| xml/System/GC.xml | Normalized indentation for sub-paragraphs under list guidance. |
| xml/System/EntryPointNotFoundException.xml | Normalized indentation for snippet directives, code fences, and continuation paragraphs. |
| xml/System/DateTimeOffset.xml | Normalized indentation for list sections and snippet directives. |
| xml/System/DateTime.xml | Normalized indentation for snippet directives and literal examples. |
| xml/System/Console.xml | Normalized indentation for snippet directives and code fences. |
| xml/System/BitConverter.xml | Normalized indentation for snippet directives under a bullet item. |
| xml/System/ArraySegment`1.xml | Normalized indentation for snippet directives under a bullet item. |
| xml/System/ArgumentNullException.xml | Fixed indentation alignment inside a Markdown table. |
| xml/System.Xml/XmlWriter.xml | Normalized indentation for Markdown tables and an XML code fence. |
| xml/System.Xml.Xsl/XslCompiledTransform.xml | Normalized indentation for a continuation paragraph under a list item. |
| xml/System.Xml.Schema/Extensions.xml | Normalized indentation for numbered steps, nested bullets, code fences, and output text. |
| xml/System.Threading/ThreadPool.xml | Normalized indentation in remarks; condensed delegate-signature formatting. |
| xml/System.Threading/Thread.xml | Normalized indentation for multi-language code fences. |
| xml/System.Threading.Tasks/Task.xml | Normalized indentation for snippet directives under list items. |
| xml/System.Text/Encoding.xml | Normalized indentation for snippet directives under a bullet item. |
| xml/System.Speech.Synthesis.TtsEngine/TtsEventId.xml | Normalized indentation for numbered steps and nested bullets. |
| xml/System.Speech.Synthesis.TtsEngine/TtsEngineSsml.xml | Normalized indentation for numbered steps and example intro text. |
| xml/System.Speech.Synthesis.TtsEngine/TtsEngineAction.xml | Normalized indentation for numbered steps and nested bullets. |
| xml/System.Speech.Synthesis.TtsEngine/TextFragment.xml | Normalized indentation for numbered steps, nested bullets, and code fence formatting. |
| xml/System.Speech.Synthesis.TtsEngine/SpeechEventInfo.xml | Normalized indentation for example intro and nested bullets. |
| xml/System.Speech.Synthesis.TtsEngine/FragmentState.xml | Normalized indentation for numbered steps and nested bullets in remarks. |
| xml/System.Speech.Synthesis.TtsEngine/EventParameterType.xml | Normalized indentation for numbered steps and nested bullets. |
| xml/System.Speech.Recognition/SemanticValue.xml | Normalized indentation for a C# code fence. |
| xml/System.Speech.Recognition/SemanticResultValue.xml | Normalized indentation for code fences and continuation paragraphs. |
| xml/System.Speech.Recognition/RecognizedAudio.xml | Normalized indentation for nested bullet lists under Events/Methods. |
| xml/System.Runtime.InteropServices/SEHException.xml | Normalized indentation for a nested bullet list. |
| xml/System.Runtime.CompilerServices/InternalsVisibleToAttribute.xml | Normalized indentation for numbered steps and link list formatting. |
| xml/System.Runtime.Caching/ChangeMonitor.xml | Normalized indentation for class lists and nested bullet guidance. |
| xml/System.Resources/ResourceWriter.xml | Normalized indentation for a Markdown table and inline literal example. |
| xml/System.Resources/ResourceReader.xml | Normalized indentation for code fences, exception lists, and remarks formatting. |
| xml/System.Reflection/ModuleResolveEventHandler.xml | Normalized indentation for numbered build/run steps and code fences. |
| xml/System.Printing/PrintCapabilities.xml | Normalized indentation for callouts and nested bullet explanations. |
| xml/System.Linq.Expressions/Expression.xml | Normalized indentation for many nested bullet lists in remarks. |
| xml/System.IO.Packaging/Package.xml | Normalized indentation for nested bullet lists. |
| xml/System.Globalization/CultureInfo.xml | Normalized indentation for snippet directives under a bullet item. |
| xml/System.DirectoryServices/DirectorySearcher.xml | Normalized indentation for a C# code fence. |
| xml/System.Diagnostics/ConditionalAttribute.xml | Normalized indentation for multi-language code fences and continuation text. |
| xml/System.Diagnostics/ActivityTagsCollection.xml | Normalized indentation for nested bullets inside the <summary> content. |
| xml/System.Diagnostics/Activity.xml | Normalized indentation for nested bullet lists in remarks. |
| xml/System.Diagnostics.Contracts/Contract.xml | Normalized indentation for callouts and removed extra blank lines; minor wording tweaks. |
| xml/System.Configuration/ConfigurationSection.xml | Normalized indentation for nested bullets and continuation paragraphs. |
| xml/System.Configuration/ConfigurationPropertyAttribute.xml | Normalized indentation for numbered list and nested bullets. |
| xml/System.Configuration/ConfigurationCollectionAttribute.xml | Normalized indentation for nested bullets. |
| xml/System.ComponentModel/BindingList`1.xml | Normalized indentation for tables, numbered steps, and nested bullets. |
| xml/System.ComponentModel.DataAnnotations/RequiredAttribute.xml | Normalized indentation for nested bullet list items. |
| xml/System.ComponentModel.DataAnnotations/RangeAttribute.xml | Normalized indentation for nested bullet list items. |
| xml/System.ComponentModel.DataAnnotations/DisplayFormatAttribute.xml | Normalized indentation for nested bullet list items. |
| xml/System.ComponentModel.DataAnnotations/DisplayColumnAttribute.xml | Normalized indentation for nested bullet list items. |
| xml/System.Collections.Concurrent/BlockingCollection`1.xml | Normalized indentation for a NOTE callout. |
| xml/System.CodeDom/CodeTypeReference.xml | Normalized indentation for code fences in remarks. |
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
gewarren
commented
Jun 18, 2026
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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 #12513.
Mostly whitespace changes.