Skip to content

Fix up list indentation#12758

Open
gewarren wants to merge 4 commits into
dotnet:mainfrom
gewarren:cleanup-061826
Open

Fix up list indentation#12758
gewarren wants to merge 4 commits into
dotnet:mainfrom
gewarren:cleanup-061826

Conversation

@gewarren

Copy link
Copy Markdown
Collaborator

Contributes to #12513.

Mostly whitespace changes.

@github-actions github-actions Bot added the area-Meta Concerns something that extends across runtime area boundaries, for example, IDisposable. label Jun 18, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

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 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.

Comment thread xml/System.Threading/ThreadPool.xml Outdated
Comment thread xml/System.Speech.Synthesis.TtsEngine/TtsEngineSsml.xml Outdated
Comment thread xml/System.Speech.Synthesis.TtsEngine/SpeechEventInfo.xml Outdated
Comment thread xml/System/GC.xml Outdated
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>
Comment thread xml/System/GC.xml Outdated
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
@gewarren gewarren marked this pull request as ready for review June 18, 2026 20:03
@gewarren gewarren enabled auto-merge (squash) June 18, 2026 20:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area-Meta Concerns something that extends across runtime area boundaries, for example, IDisposable.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants