Reinstate supplemental remarks (System/S-Z)

[gewarren]

Contributes to #12613.

Also removes .NET Framework remarks.

[Copilot]

Pull request overview

Reinstates previously external “Supplemental API remarks” back into this repo’s ECMA XML for several System types, and adds/updates a large set of snippet projects and snippet source files (C#, F#, Visual Basic) to support the restored remarks and examples.

Changes:

• Replaces “Supplemental API remarks” links with inlined markdown remarks for System.Version, System.TypeInitializationException, System.StringComparer, and System.Span<T>.
• Adds many new snippet projects and snippet source files across languages for System.Version, System.String, System.TimeSpan, System.Type, and System.Single.
• Removes an older legacy C# project file (snippets/csharp/System/String/.ctor/chptrctor_null.csproj) in favor of SDK-style snippet projects.

Reviewed changes

Copilot reviewed 193 out of 194 changed files in this pull request and generated 19 comments.

Show a summary per file

File	Description
xml/System/Version.xml	Inlines supplemental remarks and adds snippet references for version scenarios.
xml/System/TypeInitializationException.xml	Inlines supplemental remarks describing common causes and scenarios.
xml/System/StringComparer.xml	Inlines supplemental remarks about comparer behavior and usage.
xml/System/Span`1.xml	Inlines supplemental remarks about ref struct restrictions and usage patterns.
snippets/visualbasic/System/Version/Overview/Project.vbproj	Adds SDK-style VB snippet project for System.Version overview.
snippets/visualbasic/System/Version/Overview/specificassem.vb	Adds VB snippet for retrieving a specific assembly’s version.
snippets/visualbasic/System/Version/Overview/currentassem.vb	Adds VB snippet for retrieving current assembly version.
snippets/visualbasic/System/Version/Overview/currentapp.vb	Adds VB snippet for retrieving entry assembly version.
snippets/visualbasic/System/Version/Overview/comparisons1.vb	Adds VB snippet for Version.CompareTo comparison scenario.
snippets/visualbasic/System/Version/Overview/comparisons2.vb	Adds VB snippet for comparing versions with undefined components.
snippets/visualbasic/System/Version/Overview/example1.vb	Updates VB snippet for assembly version attribute example.
snippets/visualbasic/System/TypeInitializationException/Overview/Project.vbproj	Adds SDK-style VB snippet project for TypeInitializationException.
snippets/visualbasic/System/TypeInitializationException/Overview/Regex1.vb	Adds VB snippet demonstrating TypeInitializationException via regex timeout config.
snippets/visualbasic/System/TypeInitializationException/Overview/Missing1a.vb	Adds VB library snippet used for missing-assembly scenario.
snippets/visualbasic/System/TypeInitializationException/Overview/Missing1.vb	Adds VB snippet demonstrating missing assembly leading to type init failure.
snippets/visualbasic/System/TypeInitializationException/Overview/GettingVersions1.vb	Adds VB multi-scenario version retrieval snippet (referenced by Version docs).
snippets/visualbasic/System/TypeInitializationException/Overview/CtorException1.vb	Adds VB snippet demonstrating constructor exception wrapped by type initializer failure.
snippets/visualbasic/System/Type/Overview/Project.vbproj	Adds SDK-style VB snippet project for System.Type overview.
snippets/visualbasic/System/Type/Overview/GetType1.vb	Adds VB snippet demonstrating GetType usage on objects.
snippets/visualbasic/System/Type/Overview/Equals1.vb	Adds VB snippet demonstrating Type equality comparisons.
snippets/visualbasic/System/Type/MakeGenericType/Project.vbproj	Updates VB snippet project target framework for MakeGenericType examples.
snippets/visualbasic/System/Type/MakeGenericType/source.vb	Adjusts VB MakeGenericType snippet source structure/entry point.
snippets/visualbasic/System/Type/MakeGenericType/remarks.vb	Adds VB remark snippets for generic base/derived and nested generic types.
snippets/visualbasic/System/TimeSpan/TryParse/tryparsefailure1.vb	Adds VB snippet showing TimeSpan.TryParse failure behavior.
snippets/visualbasic/System/TimeSpan/Parse/parsefailure1.vb	Adds VB snippet showing TimeSpan.Parse failure behavior.
snippets/visualbasic/System/TimeSpan/Parse/parse1.vb	Updates VB parsing sample entry point/name.
snippets/visualbasic/System/TimeSpan/Overview/Project.vbproj	Adds SDK-style VB snippet project for TimeSpan overview.
snippets/visualbasic/System/TimeSpan/Overview/zero1.vb	Adds VB snippet using TimeSpan.Zero.
snippets/visualbasic/System/TimeSpan/Overview/showtimespan.vb	Adds VB snippet formatting/printing a TimeSpan.
snippets/visualbasic/System/TimeSpan/Overview/perappdomain1.vb	Adds VB snippet demonstrating AppDomain compatibility switches.
snippets/visualbasic/System/TimeSpan/Overview/legacycode1.vb	Adds VB snippet contrasting legacy formatting/parsing behavior.
snippets/visualbasic/System/TimeSpan/Overview/instantiate1.vb	Adds VB snippet demonstrating TimeSpan instantiation and operations.
snippets/visualbasic/System/String/Overview/Project.vbproj	Adds SDK-style VB snippet project for String overview.
snippets/visualbasic/System/String/Overview/surrogate1.vb	Adds VB snippet demonstrating surrogate pairs.
snippets/visualbasic/System/String/Overview/sort1.vb	Adds VB snippet demonstrating culture-sensitive sorting.
snippets/visualbasic/System/String/Overview/search1.vb	Adds VB snippet demonstrating culture-sensitive search.
snippets/visualbasic/System/String/Overview/parse1.vb	Adds VB snippet demonstrating culture-specific date parsing.
snippets/visualbasic/System/String/Overview/nullorempty1.vb	Adds VB snippet(s) demonstrating null/empty checks and formatting patterns.
snippets/visualbasic/System/String/Overview/normalize1.vb	Adds VB snippet demonstrating normalization and equality comparisons.
snippets/visualbasic/System/String/Overview/instantiate1.vb	Adds VB snippet demonstrating string creation and manipulation scenarios.
snippets/visualbasic/System/String/Overview/index1.vb	Adds VB snippet demonstrating indexing/word count.
snippets/visualbasic/System/String/Overview/index2.vb	Adds VB snippet demonstrating word count (alternate approach).
snippets/visualbasic/System/String/Overview/index3.vb	Adds VB snippet demonstrating text elements vs characters.
snippets/visualbasic/System/String/Overview/immutable.vb	Adds VB snippet demonstrating immutable string concatenation costs.
snippets/visualbasic/System/String/Overview/immutable1.vb	Adds VB snippet demonstrating StringBuilder alternative.
snippets/visualbasic/System/String/Overview/grapheme1.vb	Adds VB snippet demonstrating grapheme equality comparisons.
snippets/visualbasic/System/String/Overview/format1.vb	Adds VB snippet demonstrating culture formatting.
snippets/visualbasic/System/String/Overview/equality1.vb	Adds VB snippet demonstrating ordinal vs culture comparisons in access checks.
snippets/visualbasic/System/String/Overview/compare1.vb	Adds VB snippet demonstrating String.Compare differences.
snippets/visualbasic/System/String/Overview/compare2.vb	Adds VB snippet demonstrating word/invariant/ordinal/string sorts.
snippets/visualbasic/System/String/Overview/compare3.vb	Adds VB snippet demonstrating substring search differences.
snippets/visualbasic/System/String/Overview/compare4.vb	Adds VB snippet demonstrating comparisons across cultures and ordinal.
snippets/visualbasic/System/String/Overview/case1.vb	Adds VB snippet demonstrating casing differences across cultures.
snippets/visualbasic/System/String/Overview/case2.vb	Adds VB snippet demonstrating current-culture ignore-case pitfalls.
snippets/visualbasic/System/String/IsNullOrEmpty/NullString1.vb	Adds VB snippet demonstrating null string behavior and length access.
snippets/visualbasic/System/String/IsNullOrEmpty/isnullorempty1.vb	Adds VB snippet demonstrating a null/empty predicate implementation.
snippets/visualbasic/System/String/Format/Project.vbproj	Adds SDK-style VB snippet project for String.Format examples.
snippets/visualbasic/System/String/Format/starting1.vb	Adds VB introductory String.Format examples.
snippets/visualbasic/System/String/Format/starting2.vb	Adds VB introductory String.Format examples (continued).
snippets/visualbasic/System/String/Format/qa1.vb	Adds VB Q&A snippet for composite formatting with arrays.
snippets/visualbasic/System/String/Format/qa2.vb	Adds VB Q&A snippet for composite formatting with boxed values.
snippets/visualbasic/System/String/Format/qa3.vb	Adds VB Q&A snippet about escaping braces in format strings.
snippets/visualbasic/System/String/Format/qa26.vb	Adds VB Q&A snippet demonstrating format strings with multiple specifiers.
snippets/visualbasic/System/String/Format/qa27.vb	Adds VB Q&A snippet demonstrating numeric format custom patterns.
snippets/visualbasic/System/String/Format/qa28.vb	Adds VB Q&A snippet demonstrating custom numeric formats.
snippets/visualbasic/System/String/Format/qa29.vb	Adds VB Q&A snippet demonstrating padding/hex formats.
snippets/visualbasic/System/String/Format/qa-interpolated1.vb	Adds VB snippet comparing composite formatting to concatenation.
snippets/visualbasic/System/String/Format/qa-interpolated2.vb	Adds VB snippet demonstrating interpolated string equivalent.
snippets/visualbasic/System/String/Format/formatsyntax1.vb	Adds VB snippet demonstrating format string syntax.
snippets/visualbasic/System/String/Format/formatoverload1.vb	Adds VB snippet demonstrating a String.Format overload.
snippets/visualbasic/System/String/Format/formatoverload2.vb	Adds VB snippet demonstrating aligned tabular output.
snippets/visualbasic/System/String/Format/FormatExample2.vb	Adds VB snippet demonstrating custom format provider/formatter.
snippets/visualbasic/System/String/Format/Example1.vb	Adds VB snippet formatting Int16 as decimal/hex.
snippets/visualbasic/System/String/Format/Example2.vb	Updates VB culture-based formatting example module name/whitespace.
snippets/visualbasic/System/String/Format/interceptor2.vb	Adds VB snippet implementing an intercepting formatter example.
snippets/visualbasic/System/String/.ctor/Project.vbproj	Adds SDK-style VB snippet project for String constructors.
snippets/visualbasic/System/String/.ctor/source.vb	Adds VB snippet source demonstrating several String constructors.
snippets/visualbasic/System/String/.ctor/ctor1.vb	Adds VB snippet demonstrating string assignment/immutability basics.
snippets/visualbasic/System/Single/Overview/Project.vbproj	Adds SDK-style VB snippet project for Single overview.
snippets/visualbasic/System/Single/Overview/representation1.vb	Adds VB snippet showing representation/rounding effects.
snippets/visualbasic/System/Single/Overview/representation2.vb	Adds VB snippet showing Single.Epsilon magnitude example.
snippets/visualbasic/System/Single/Overview/precisionlist1.vb	Adds VB snippet showing Double vs Single comparison.
snippets/visualbasic/System/Single/Overview/precisionlist3.vb	Adds VB snippet demonstrating accumulation error differences.
snippets/visualbasic/System/Single/Overview/PrecisionList4a.vb	Adds VB snippet showing persistence/parse and equality differences.
snippets/visualbasic/System/Single/Overview/exceptional1.vb	Adds VB snippet demonstrating underflow/zero equality.
snippets/visualbasic/System/Single/Overview/exceptional2.vb	Adds VB snippet demonstrating overflow/infinity checks.
snippets/visualbasic/System/Single/Overview/convert1.vb	Adds VB snippet demonstrating conversion to Single.
snippets/visualbasic/System/Single/Overview/convert2.vb	Adds VB snippet demonstrating checked conversions and exceptions.
snippets/visualbasic/System/Single/Overview/comparison1.vb	Adds VB snippet demonstrating floating-point equality pitfalls.
snippets/visualbasic/System/Single/Overview/comparison2.vb	Adds VB snippet demonstrating rounding differences after operations.
snippets/visualbasic/System/Single/Overview/comparison3.vb	Adds VB snippet demonstrating rounding to precision before compare.
snippets/visualbasic/System/Single/Overview/comparison4.vb	Adds VB snippet demonstrating approximate equality helper.
snippets/visualbasic/System/Single/Equals/Project.vbproj	Adds SDK-style VB snippet project for Single.Equals examples.
snippets/visualbasic/System/Single/Equals/equalsoverl.vb	Updates VB overload-equality example module name/whitespace.
snippets/visualbasic/System/Single/Equals/equalsabs1.vb	Adds VB snippet demonstrating bitwise-distance-based comparison.
snippets/visualbasic/System/Single/Epsilon/Project.vbproj	Adds SDK-style VB snippet project for Single.Epsilon examples.
snippets/visualbasic/System/Single/Epsilon/epsilon.vb	Adds VB snippet comparing epsilon values.
snippets/visualbasic/System/Single/Epsilon/epsilon1.vb	Adds VB snippet decomposing float into sign/exponent/mantissa.
snippets/visualbasic/System/Single/Epsilon/SingleEquals_25051.vb	Adds VB snippet demonstrating approximate comparisons using epsilon-based tolerance.
snippets/visualbasic/System/Single/CompareTo/Project.vbproj	Adds SDK-style VB snippet project for Single.CompareTo examples.
snippets/visualbasic/System/Single/CompareTo/compareto2.vb	Adds VB snippet comparing Single values and CompareTo results.
snippets/visualbasic/System/Single/CompareTo/compareto3.vb	Adds VB snippet comparing boxed operands and CompareTo results.
snippets/fsharp/System/Type/MakeGenericType/remarks.fs	Adds F# remarks snippet for generic base/derived example.
snippets/fsharp/System/TimeSpan/TryParse/tryparsefailure1.fs	Adds F# snippet for TimeSpan.TryParse failure example.
snippets/fsharp/System/TimeSpan/Parse/parsefailure1.fs	Adds F# snippet for TimeSpan.Parse failure example.
snippets/fsharp/System/String/IsNullOrEmpty/NullString1.fs	Adds F# snippet demonstrating null string exception handling.
snippets/fsharp/System/String/IsNullOrEmpty/NullString2.fs	Adds F# snippet demonstrating empty string length.
snippets/fsharp/System/String/IsNullOrEmpty/isnullorempty1.fs	Adds F# snippet implementing a null/empty predicate.
snippets/fsharp/System/String/Format/Example1.fs	Adds F# snippet demonstrating String.Format usage.
snippets/fsharp/System/String/.ctor/source.fs	Adds F# snippet source demonstrating String constructors (including pointer scenarios).
snippets/fsharp/System/String/.ctor/ctor1.fs	Adds F# snippet demonstrating string assignment.
snippets/fsharp/System/String/.ctor/ctor2.fs	Adds F# snippet demonstrating pointer-based constructor.
snippets/fsharp/System/String/.ctor/chptrctor_null.fs	Adds F# snippet demonstrating null-terminated char-pointer constructor behavior.
snippets/fsharp/System/String/.ctor/ptrctor_null.fs	Adds F# snippet demonstrating null-terminated byte-pointer constructor behavior.
snippets/fsharp/System/String/.ctor/char2_ctor.fs	Adds F# snippet demonstrating a length-limited char pointer constructor.
snippets/fsharp/System/Single/Equals/equalsabs1.fs	Adds F# snippet demonstrating bitwise-distance-based comparison.
snippets/fsharp/System/Single/Epsilon/epsilon.fs	Adds F# snippet comparing epsilon values.
snippets/fsharp/System/Single/Epsilon/epsilon1.fs	Adds F# snippet decomposing float into sign/exponent/mantissa.
snippets/fsharp/System/Single/CompareTo/compareto2.fs	Adds F# snippet for Single.CompareTo.
snippets/fsharp/System/Single/CompareTo/compareto3.fs	Adds F# snippet for Single.CompareTo with boxed operand.
snippets/csharp/System/Version/Overview/Project.csproj	Adds SDK-style C# snippet project for System.Version overview.
snippets/csharp/System/Version/Overview/GettingVersions1.cs	Adds C# multi-scenario version retrieval snippet.
snippets/csharp/System/Version/Overview/currentapp.cs	Adds C# snippet for entry assembly version retrieval.
snippets/csharp/System/Version/Overview/currentassem.cs	Adds C# snippet for current assembly version retrieval.
snippets/csharp/System/Version/Overview/specificassem.cs	Adds C# snippet for loading version of a specific assembly.
snippets/csharp/System/Version/Overview/comparisons1.cs	Adds C# snippet demonstrating Version.CompareTo basic comparison.
snippets/csharp/System/Version/Overview/comparisons2.cs	Adds C# snippet comparing versions with undefined components.
snippets/csharp/System/Version/Overview/example1.cs	Minor C# snippet formatting adjustment.
snippets/csharp/System/TypeInitializationException/Overview/project.csproj	Adds SDK-style C# snippet project for TypeInitializationException scenarios.
snippets/csharp/System/TypeInitializationException/Overview/Regex1.cs	Adds C# snippet demonstrating regex timeout leading to type init failure.
snippets/csharp/System/TypeInitializationException/Overview/Missing1a.cs	Adds C# library snippet for missing-assembly scenario.
snippets/csharp/System/TypeInitializationException/Overview/Missing1.cs	Adds C# snippet demonstrating missing dependency and type initializer failure.
snippets/csharp/System/TypeInitializationException/Overview/ctorException1.cs	Adds C# snippet demonstrating static init exception wrapping.
snippets/csharp/System/Type/Overview/Project.csproj	Adds SDK-style C# snippet project for System.Type overview.
snippets/csharp/System/Type/Overview/source.cs	Updates C# Type overview snippet class name/formatting.
snippets/csharp/System/Type/Overview/GetType1.cs	Adds C# snippet demonstrating GetType over object array.
snippets/csharp/System/Type/Overview/Equals1.cs	Adds C# snippet demonstrating Type equality.
snippets/csharp/System/Type/MakeGenericType/remarks.cs	Adds C# remarks snippets for generic inheritance/nesting examples.
snippets/csharp/System/TimeSpan/TryParse/Project.csproj	Adds SDK-style C# snippet project for TimeSpan.TryParse.
snippets/csharp/System/TimeSpan/TryParse/tryparsefailure1.cs	Adds C# snippet for TimeSpan.TryParse failure behavior.
snippets/csharp/System/TimeSpan/Parse/Project.csproj	Adds SDK-style C# snippet project for TimeSpan.Parse.
snippets/csharp/System/TimeSpan/Parse/parsefailure1.cs	Adds C# snippet for TimeSpan.Parse failure behavior.
snippets/csharp/System/TimeSpan/Parse/parse1.cs	Updates C# parsing example class name/formatting.
snippets/csharp/System/TimeSpan/Parse/parse2.cs	Updates C# parsing table example class name/formatting.
snippets/csharp/System/TimeSpan/Overview/Project.csproj	Adds SDK-style C# snippet project for TimeSpan overview.
snippets/csharp/System/TimeSpan/Overview/zero1.cs	Adds C# snippet for TimeSpan.Zero usage.
snippets/csharp/System/TimeSpan/Overview/structure1.cs	Updates C# structure snippet class name.
snippets/csharp/System/TimeSpan/Overview/showtimespan.cs	Adds C# snippet formatting/printing a TimeSpan.
snippets/csharp/System/TimeSpan/Overview/perappdomain1.cs	Adds C# snippet demonstrating AppDomain compatibility switches.
snippets/csharp/System/TimeSpan/Overview/legacycode1.cs	Adds C# snippet contrasting legacy behavior.
snippets/csharp/System/TimeSpan/Overview/instantiate1.cs	Adds C# snippet demonstrating TimeSpan instantiation and operations.
snippets/csharp/System/String/IsNullOrEmpty/Project.csproj	Adds SDK-style C# snippet project for String.IsNullOrEmpty examples.
snippets/csharp/System/String/IsNullOrEmpty/NullString1.cs	Adds C# snippet demonstrating null string output and exception.
snippets/csharp/System/String/IsNullOrEmpty/isnullorempty1.cs	Adds C# snippet implementing a null/empty predicate.
snippets/csharp/System/String/Format/Project.csproj	Adds SDK-style C# snippet project for String.Format examples.
snippets/csharp/System/String/Format/Example1.cs	Adds C# snippet formatting Int16 as decimal/hex.
snippets/csharp/System/String/Format/Example2.cs	Updates C# culture-based formatting example class name/formatting.
snippets/csharp/System/String/.ctor/Project.csproj	Adds SDK-style C# snippet project for String constructors (unsafe enabled).
snippets/csharp/System/String/.ctor/source.cs	Adds C# snippet source demonstrating multiple String constructors.
snippets/csharp/System/String/.ctor/ctor1.cs	Adds C# snippet demonstrating string assignment.
snippets/csharp/System/String/.ctor/ctor2.cs	Adds C# snippet demonstrating pointer-based constructor.
snippets/csharp/System/String/.ctor/chptrctor_null.cs	Adds C# snippet demonstrating null-terminated char-pointer constructor behavior.
snippets/csharp/System/String/.ctor/ptrctor_null.cs	Adds C# snippet demonstrating null-terminated byte-pointer constructor behavior.
snippets/csharp/System/String/.ctor/char2_ctor.cs	Adds C# snippet demonstrating length-limited char pointer constructor.
snippets/csharp/System/String/.ctor/chptrctor_null.csproj	Removes legacy non-SDK C# project file.
snippets/csharp/System/Single/Overview/Project.csproj	Adds SDK-style C# snippet project for Single overview (StartupObject specified).
snippets/csharp/System/Single/Overview/representation1.cs	Adds C# snippet showing representation/rounding effects.
snippets/csharp/System/Single/Overview/representation2.cs	Adds C# snippet showing Single.Epsilon magnitude example.
snippets/csharp/System/Single/Overview/precisionlist1.cs	Adds C# snippet showing Double vs Single comparison.
snippets/csharp/System/Single/Overview/precisionlist3.cs	Adds C# snippet demonstrating accumulation error differences.
snippets/csharp/System/Single/Overview/precisionlist4a.cs	Adds C# snippet showing persistence/parse and equality differences.
snippets/csharp/System/Single/Overview/exceptional1.cs	Adds C# snippet demonstrating underflow/zero equality.
snippets/csharp/System/Single/Overview/exceptional2.cs	Adds C# snippet demonstrating overflow/infinity checks.
snippets/csharp/System/Single/Overview/convert1.cs	Adds C# snippet demonstrating conversion to Single.
snippets/csharp/System/Single/Overview/convert2.cs	Adds C# snippet demonstrating checked conversions and exceptions.
snippets/csharp/System/Single/Overview/comparison1.cs	Adds C# snippet demonstrating floating-point equality pitfalls.
snippets/csharp/System/Single/Overview/comparison2.cs	Adds C# snippet demonstrating rounding differences after operations.
snippets/csharp/System/Single/Overview/comparison3.cs	Adds C# snippet demonstrating rounding to precision before compare.
snippets/csharp/System/Single/Overview/comparison4.cs	Adds C# snippet demonstrating approximate equality helper.
snippets/csharp/System/Single/Equals/Project.csproj	Adds SDK-style C# snippet project for Single.Equals examples.
snippets/csharp/System/Single/Equals/equalsoverl.cs	Updates C# overload-equality example class name/formatting.
snippets/csharp/System/Single/Equals/equalsabs1.cs	Adds C# snippet demonstrating bitwise-distance-based comparison.
snippets/csharp/System/Single/Epsilon/Project.csproj	Adds SDK-style C# snippet project for Single.Epsilon examples.
snippets/csharp/System/Single/Epsilon/epsilon.cs	Adds C# snippet comparing epsilon values.
snippets/csharp/System/Single/Epsilon/epsilon1.cs	Adds C# snippet decomposing float into sign/exponent/mantissa.
snippets/csharp/System/Single/CompareTo/Project.csproj	Adds SDK-style C# snippet project for Single.CompareTo examples.
snippets/csharp/System/Single/CompareTo/compareto2.cs	Adds C# snippet for Single.CompareTo.
snippets/csharp/System/Single/CompareTo/compareto3.cs	Adds C# snippet for Single.CompareTo with boxed operand.

[gewarren]

Snippets 5000 errors are for missing .fsproj files.

[BillWagner]

This also LGTM (modernizing the code comment applies here too.)