From 4a53278bafb91896270a179a588678e0dfff4385 Mon Sep 17 00:00:00 2001 From: Jeff Handley Date: Fri, 20 Feb 2026 18:43:29 -0800 Subject: [PATCH 1/2] Remove NuGet package references from System.Collections.Immutable docs Remove self-referencing NuGet package links from all 36 files in System.Collections.Immutable, the ImmutableArrayExtensions in System.Linq, and the namespace doc. These references to the package that the APIs ship in are unnecessary. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .../IImmutableDictionary`2.xml | 5 +- .../IImmutableList`1.xml | 4 +- .../IImmutableQueue`1.xml | 4 +- .../IImmutableSet`1.xml | 4 +- .../IImmutableStack`1.xml | 4 +- .../ImmutableArray.xml | 4 +- .../ImmutableArray`1+Builder.xml | 4 +- .../ImmutableArray`1+Enumerator.xml | 4 +- .../ImmutableArray`1.xml | 4 +- .../ImmutableDictionary.xml | 4 +- .../ImmutableDictionary`2+Builder.xml | 4 +- .../ImmutableDictionary`2+Enumerator.xml | 4 +- .../ImmutableDictionary`2.xml | 4 +- .../ImmutableHashSet.xml | 4 +- .../ImmutableHashSet`1+Builder.xml | 4 +- .../ImmutableHashSet`1+Enumerator.xml | 4 +- .../ImmutableHashSet`1.xml | 4 +- .../ImmutableInterlocked.xml | 4 +- .../ImmutableList.xml | 4 +- .../ImmutableList`1+Builder.xml | 4 +- .../ImmutableList`1+Enumerator.xml | 4 +- .../ImmutableList`1.xml | 4 +- .../ImmutableQueue.xml | 4 +- .../ImmutableQueue`1+Enumerator.xml | 4 +- .../ImmutableQueue`1.xml | 8 +- .../ImmutableSortedDictionary.xml | 4 +- .../ImmutableSortedDictionary`2+Builder.xml | 8 +- ...ImmutableSortedDictionary`2+Enumerator.xml | 4 +- .../ImmutableSortedDictionary`2.xml | 4 +- .../ImmutableSortedSet.xml | 4 +- .../ImmutableSortedSet`1+Builder.xml | 4 +- .../ImmutableSortedSet`1+Enumerator.xml | 20 +- .../ImmutableSortedSet`1.xml | 338 ++---------------- .../ImmutableStack.xml | 4 +- .../ImmutableStack`1+Enumerator.xml | 4 +- .../ImmutableStack`1.xml | 4 +- xml/System.Linq/ImmutableArrayExtensions.xml | 4 +- xml/ns-System.Collections.Immutable.xml | 2 - 38 files changed, 62 insertions(+), 447 deletions(-) diff --git a/xml/System.Collections.Immutable/IImmutableDictionary`2.xml b/xml/System.Collections.Immutable/IImmutableDictionary`2.xml index 6d9fc771a90..394be3d5e6d 100644 --- a/xml/System.Collections.Immutable/IImmutableDictionary`2.xml +++ b/xml/System.Collections.Immutable/IImmutableDictionary`2.xml @@ -65,10 +65,7 @@ The type of keys in the dictionary. The type of values in the dictionary. - Represents an immutable collection of key/value pairs. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) - + Represents an immutable collection of key/value pairs. The type of elements in the list. - Represents a list of elements that cannot be modified. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Represents a list of elements that cannot be modified. The type of elements in the queue. - Represents an immutable first-in, first-out collection of objects. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Represents an immutable first-in, first-out collection of objects. The type of element stored in the set. - Represents a set of elements that can only be modified by creating a new instance of the set. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Represents a set of elements that can only be modified by creating a new instance of the set. The type of elements in the stack. - Represents an immutable last-in-first-out (LIFO) collection. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Represents an immutable last-in-first-out (LIFO) collection. To be added. diff --git a/xml/System.Collections.Immutable/ImmutableArray.xml b/xml/System.Collections.Immutable/ImmutableArray.xml index 79348fd29a1..69b8ad8da4d 100644 --- a/xml/System.Collections.Immutable/ImmutableArray.xml +++ b/xml/System.Collections.Immutable/ImmutableArray.xml @@ -35,9 +35,7 @@ - Provides methods for creating an array that is immutable; meaning it cannot be changed once it is created. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Provides methods for creating an array that is immutable; meaning it cannot be changed once it is created. To be added. This type is thread safe. diff --git a/xml/System.Collections.Immutable/ImmutableArray`1+Builder.xml b/xml/System.Collections.Immutable/ImmutableArray`1+Builder.xml index 7dfaf646fb8..b18f0761b50 100644 --- a/xml/System.Collections.Immutable/ImmutableArray`1+Builder.xml +++ b/xml/System.Collections.Immutable/ImmutableArray`1+Builder.xml @@ -73,9 +73,7 @@ - A writable array accessor that can be converted into an instance without allocating extra memory. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + A writable array accessor that can be converted into an instance without allocating extra memory. To be added. diff --git a/xml/System.Collections.Immutable/ImmutableArray`1+Enumerator.xml b/xml/System.Collections.Immutable/ImmutableArray`1+Enumerator.xml index 1b1af59073d..2dd2b411a06 100644 --- a/xml/System.Collections.Immutable/ImmutableArray`1+Enumerator.xml +++ b/xml/System.Collections.Immutable/ImmutableArray`1+Enumerator.xml @@ -45,9 +45,7 @@ - An array enumerator. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + An array enumerator. The type of element stored by the array. - Represents an array that is immutable; meaning it cannot be changed once it is created. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Represents an array that is immutable; meaning it cannot be changed once it is created. - Provides a set of initialization methods for instances of the class. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Provides a set of initialization methods for instances of the class. To be added. This type is thread safe. diff --git a/xml/System.Collections.Immutable/ImmutableDictionary`2+Builder.xml b/xml/System.Collections.Immutable/ImmutableDictionary`2+Builder.xml index 80a8e7cf914..2a2e7a9092e 100644 --- a/xml/System.Collections.Immutable/ImmutableDictionary`2+Builder.xml +++ b/xml/System.Collections.Immutable/ImmutableDictionary`2+Builder.xml @@ -87,9 +87,7 @@ - Represents a hash map that mutates with little or no memory allocations and that can produce or build on immutable hash map instances very efficiently. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Represents a hash map that mutates with little or no memory allocations and that can produce or build on immutable hash map instances very efficiently. - Enumerates the contents of the immutable dictionary without allocating any memory. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Enumerates the contents of the immutable dictionary without allocating any memory. To be added. This type is thread safe. diff --git a/xml/System.Collections.Immutable/ImmutableDictionary`2.xml b/xml/System.Collections.Immutable/ImmutableDictionary`2.xml index 04fd0ad31a2..16f6906f140 100644 --- a/xml/System.Collections.Immutable/ImmutableDictionary`2.xml +++ b/xml/System.Collections.Immutable/ImmutableDictionary`2.xml @@ -93,9 +93,7 @@ The type of the keys in the dictionary. The type of the values in the dictionary. - Represents an immutable, unordered collection of keys and values. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Represents an immutable, unordered collection of keys and values. - Provides a set of initialization methods for instances of the class. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Provides a set of initialization methods for instances of the class. To be added. This type is thread safe. diff --git a/xml/System.Collections.Immutable/ImmutableHashSet`1+Builder.xml b/xml/System.Collections.Immutable/ImmutableHashSet`1+Builder.xml index c27b2a22129..4cc1839550c 100644 --- a/xml/System.Collections.Immutable/ImmutableHashSet`1+Builder.xml +++ b/xml/System.Collections.Immutable/ImmutableHashSet`1+Builder.xml @@ -66,9 +66,7 @@ - Represents a hash set that mutates with little or no memory allocations and that can produce or build on immutable hash set instances very efficiently. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Represents a hash set that mutates with little or no memory allocations and that can produce or build on immutable hash set instances very efficiently. - Enumerates the contents of the immutable hash set without allocating any memory. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Enumerates the contents of the immutable hash set without allocating any memory. To be added. This type is thread safe. diff --git a/xml/System.Collections.Immutable/ImmutableHashSet`1.xml b/xml/System.Collections.Immutable/ImmutableHashSet`1.xml index 85f3f5b6872..fa814a2055c 100644 --- a/xml/System.Collections.Immutable/ImmutableHashSet`1.xml +++ b/xml/System.Collections.Immutable/ImmutableHashSet`1.xml @@ -94,9 +94,7 @@ The type of elements in the hash set. - Represents an immutable, unordered hash set. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Represents an immutable, unordered hash set. - Contains interlocked exchange mechanisms for immutable collections. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Contains interlocked exchange mechanisms for immutable collections. To be added. This type is thread safe. diff --git a/xml/System.Collections.Immutable/ImmutableList.xml b/xml/System.Collections.Immutable/ImmutableList.xml index 4c9afffd851..c1e5e4615d2 100644 --- a/xml/System.Collections.Immutable/ImmutableList.xml +++ b/xml/System.Collections.Immutable/ImmutableList.xml @@ -35,9 +35,7 @@ - Provides a set of initialization methods for instances of the class. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Provides a set of initialization methods for instances of the class. To be added. This type is thread safe. diff --git a/xml/System.Collections.Immutable/ImmutableList`1+Builder.xml b/xml/System.Collections.Immutable/ImmutableList`1+Builder.xml index 746527345a5..04846e52f3d 100644 --- a/xml/System.Collections.Immutable/ImmutableList`1+Builder.xml +++ b/xml/System.Collections.Immutable/ImmutableList`1+Builder.xml @@ -79,9 +79,7 @@ - Represents a list that mutates with little or no memory allocations and that can produce or build on immutable list instances very efficiently. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Represents a list that mutates with little or no memory allocations and that can produce or build on immutable list instances very efficiently. - Enumerates the contents of a binary tree. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Enumerates the contents of a binary tree. The type of elements in the list. - Represents an immutable list, which is a strongly typed list of objects that can be accessed by index. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Represents an immutable list, which is a strongly typed list of objects that can be accessed by index. - Provides a set of initialization methods for instances of the class. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Provides a set of initialization methods for instances of the class. - Enumerates the contents of an immutable queue without allocating any memory. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Enumerates the contents of an immutable queue without allocating any memory. To be added. This type is thread safe. diff --git a/xml/System.Collections.Immutable/ImmutableQueue`1.xml b/xml/System.Collections.Immutable/ImmutableQueue`1.xml index 35e4ac0a60e..ea47e2636a0 100644 --- a/xml/System.Collections.Immutable/ImmutableQueue`1.xml +++ b/xml/System.Collections.Immutable/ImmutableQueue`1.xml @@ -73,9 +73,7 @@ The type of elements in the queue. - Represents an immutable queue. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Represents an immutable queue. To be added. This type is thread safe. @@ -329,9 +327,7 @@ System.Boolean - Gets a value that indicates whether this immutable queue is empty. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Gets a value that indicates whether this immutable queue is empty. if this queue is empty; otherwise, . To be added. diff --git a/xml/System.Collections.Immutable/ImmutableSortedDictionary.xml b/xml/System.Collections.Immutable/ImmutableSortedDictionary.xml index 8d7a2f2d2ed..1761cad29d5 100644 --- a/xml/System.Collections.Immutable/ImmutableSortedDictionary.xml +++ b/xml/System.Collections.Immutable/ImmutableSortedDictionary.xml @@ -35,9 +35,7 @@ - Provides a set of initialization methods for instances of the class. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Provides a set of initialization methods for instances of the class. To be added. This type is thread safe. diff --git a/xml/System.Collections.Immutable/ImmutableSortedDictionary`2+Builder.xml b/xml/System.Collections.Immutable/ImmutableSortedDictionary`2+Builder.xml index b8470c6052b..1d727901507 100644 --- a/xml/System.Collections.Immutable/ImmutableSortedDictionary`2+Builder.xml +++ b/xml/System.Collections.Immutable/ImmutableSortedDictionary`2+Builder.xml @@ -87,9 +87,7 @@ - Represents a sorted dictionary that mutates with little or no memory allocations and that can produce or build on immutable sorted dictionary instances very efficiently. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Represents a sorted dictionary that mutates with little or no memory allocations and that can produce or build on immutable sorted dictionary instances very efficiently. The one-dimensional array that is the destination of the elements copied from the dictionary. The array must have zero-based indexing. The zero-based index in at which copying begins. - Copies the elements of the dictionary to an array, starting at a particular array index. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Copies the elements of the dictionary to an array, starting at a particular array index. - Enumerates the contents of a binary tree. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Enumerates the contents of a binary tree. The type of the key contained in the dictionary. The type of the value contained in the dictionary. - Represents an immutable sorted dictionary. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Represents an immutable sorted dictionary. To be added. This type is thread safe. diff --git a/xml/System.Collections.Immutable/ImmutableSortedSet.xml b/xml/System.Collections.Immutable/ImmutableSortedSet.xml index 7cdca09e195..b568be7ddcc 100644 --- a/xml/System.Collections.Immutable/ImmutableSortedSet.xml +++ b/xml/System.Collections.Immutable/ImmutableSortedSet.xml @@ -35,9 +35,7 @@ - Provides a set of initialization methods for instances of the class. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Provides a set of initialization methods for instances of the class. To be added. This type is thread safe. diff --git a/xml/System.Collections.Immutable/ImmutableSortedSet`1+Builder.xml b/xml/System.Collections.Immutable/ImmutableSortedSet`1+Builder.xml index 1a45e495fcc..49c839ee872 100644 --- a/xml/System.Collections.Immutable/ImmutableSortedSet`1+Builder.xml +++ b/xml/System.Collections.Immutable/ImmutableSortedSet`1+Builder.xml @@ -73,9 +73,7 @@ - Represents a sorted set that enables changes with little or no memory allocations, and efficiently manipulates or builds immutable sorted sets. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Represents a sorted set that enables changes with little or no memory allocations, and efficiently manipulates or builds immutable sorted sets. - Enumerates the contents of a binary tree. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Enumerates the contents of a binary tree. T - Gets the element at the current position of the enumerator. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Gets the element at the current position of the enumerator. The element at the current position of the enumerator. To be added. @@ -151,9 +147,7 @@ - Releases the resources used by the current instance of the class. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Releases the resources used by the current instance of the class. To be added. @@ -190,9 +184,7 @@ - Advances the enumerator to the next element of the immutable sorted set. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Advances the enumerator to the next element of the immutable sorted set. if the enumerator was successfully advanced to the next element; if the enumerator has passed the end of the sorted set. To be added. @@ -231,9 +223,7 @@ - Sets the enumerator to its initial position, which is before the first element in the immutable sorted set. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Sets the enumerator to its initial position, which is before the first element in the immutable sorted set. To be added. diff --git a/xml/System.Collections.Immutable/ImmutableSortedSet`1.xml b/xml/System.Collections.Immutable/ImmutableSortedSet`1.xml index f2a49937d6b..c343a26b442 100644 --- a/xml/System.Collections.Immutable/ImmutableSortedSet`1.xml +++ b/xml/System.Collections.Immutable/ImmutableSortedSet`1.xml @@ -103,10 +103,7 @@ The type of elements in the set. - Represents an immutable sorted set implementation. - -**NuGet package**: System.Collections.Immutable (about immutable collections and how to install) - + Represents an immutable sorted set implementation. The value to add. Adds the specified value to this immutable sorted set. A new set with the element added, or this set if the element is already in this set. - - - + To be added. @@ -201,17 +188,7 @@ If you need to perform multiple operations on an immutable collection, to increa Removes all elements from the immutable sorted set. An empty set with the elements removed. - - - + To be added. @@ -255,17 +232,7 @@ If you need to perform multiple operations on an immutable collection, to increa Determines whether this immutable sorted set contains the specified value. if the set contains the specified value; otherwise, . - - - + To be added. @@ -304,17 +271,7 @@ If you need to perform multiple operations on an immutable collection, to increa Gets the number of elements in the immutable sorted set. The number of elements in the immutable sorted set. - - - + To be added. @@ -385,17 +342,7 @@ If you need to perform multiple operations on an immutable collection, to increa The items to remove from this set. Removes a specified set of items from this immutable sorted set. A new set with the items removed; or the original set if none of the items were in the set. - - - + To be added. @@ -441,9 +388,6 @@ If you need to perform multiple operations on an immutable collection, to increa > [!CAUTION] > When you use this enumerator as a value type (that is, when it isn't boxed), do not copy it by assigning it to a second variable or by passing it to another method. When this enumerator is disposed of, it returns a mutable reference type stack to a resource pool, and if the value type enumerator is copied (which can easily happen unintentionally if you pass the value around), there is a risk that a stack that has already been returned to the resource pool may still be in use by one of the enumerator copies, leading to data corruption and exceptions. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -487,17 +431,7 @@ If you need to perform multiple operations on an immutable collection, to increa The value whose position is being sought. Gets the position within this immutable sorted set that the specified value appears in. The index of the specified in the sorted set, if is found. If is not found and is less than one or more elements in this set, this method returns a negative number that is the bitwise complement of the index of the first element that is larger than value. If is not found and is greater than any of the elements in the set, this method returns a negative number that is the bitwise complement of the index of the last element plus 1. - - - + To be added. @@ -535,17 +469,7 @@ If you need to perform multiple operations on an immutable collection, to increa The set to intersect with this one. Creates an immutable sorted set that contains elements that exist both in this set and in the specified set. A new immutable sorted set that contains any elements that exist in both sets. - - - + To be added. @@ -580,17 +504,7 @@ If you need to perform multiple operations on an immutable collection, to increa Gets a value that indicates whether this immutable sorted set is empty. if this set is empty; otherwise, . - - - + To be added. @@ -640,9 +554,6 @@ If you need to perform multiple operations on an immutable collection, to increa ## Remarks An empty set is a subset of any other collection. Therefore, this method returns `true` if the current set is empty, unless the `other` collection is also empty. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -696,9 +607,6 @@ An empty set is a subset of any other collection. Therefore, this method returns An empty set is a subset of any other collection. Therefore, this method returns `true` if the collection represented by the `other` parameter is empty, unless the current set is also empty. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -752,9 +660,6 @@ An empty set is a subset of any other collection. Therefore, this method returns An empty set is a subset of any other set, including another empty set. Therefore, this method returns `true` if the current set is empty, even if the `other` collection is also empty. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -808,9 +713,6 @@ An empty set is a subset of any other set, including another empty set. Therefor All collections, including empty sets, are supersets of an empty set. Therefore, this method returns `true` if the collection represented by the `other` parameter is empty, even if the current sorted set is empty. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -854,17 +756,7 @@ All collections, including empty sets, are supersets of an empty set. Therefore, The index of the element to retrieve from the sorted set. Gets the element of the immutable sorted set at the given index. The element at the given index. - - - + To be added. @@ -938,17 +830,7 @@ All collections, including empty sets, are supersets of an empty set. Therefore, Gets the comparer used to sort keys in the immutable sorted set. The comparer used to sort keys. - - - + To be added. @@ -989,17 +871,7 @@ All collections, including empty sets, are supersets of an empty set. Therefore, Gets the maximum value in the immutable sorted set, as defined by the comparer. The maximum value in the set. - - - + To be added. @@ -1040,17 +912,7 @@ All collections, including empty sets, are supersets of an empty set. Therefore, Gets the minimum value in the immutable sorted set, as defined by the comparer. The minimum value in the set. - - - + To be added. @@ -1094,17 +956,7 @@ All collections, including empty sets, are supersets of an empty set. Therefore, Determines whether the current immutable sorted set and a specified collection share common elements. if the current set and share at least one common element; otherwise, . - - - + To be added. @@ -1142,17 +994,7 @@ All collections, including empty sets, are supersets of an empty set. Therefore, The element to remove. Removes the specified value from this immutable sorted set. A new immutable sorted set with the element removed, or this set if the element was not found in the set. - - - + To be added. @@ -1187,17 +1029,7 @@ All collections, including empty sets, are supersets of an empty set. Therefore, Returns an that iterates over this immutable sorted set in reverse order. An enumerator that iterates over the immutable sorted set in reverse order. - - - + To be added. @@ -1241,17 +1073,7 @@ All collections, including empty sets, are supersets of an empty set. Therefore, Determines whether the current immutable sorted set and the specified collection contain the same elements. if the sets are equal; otherwise, . - - - + To be added. @@ -1289,17 +1111,7 @@ All collections, including empty sets, are supersets of an empty set. Therefore, The other sequence of items. Creates an immutable sorted set that contains elements that exist either in this set or in a given sequence, but not both. The new immutable sorted set. - - - + To be added. @@ -1346,9 +1158,6 @@ All collections, including empty sets, are supersets of an empty set. Therefore, This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -1395,9 +1204,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -1449,9 +1255,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -1540,9 +1343,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -1590,9 +1390,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -1644,9 +1441,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -1737,9 +1531,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -1791,9 +1582,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -1843,9 +1631,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -1895,9 +1680,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -1947,9 +1729,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -1999,9 +1778,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -2053,9 +1829,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -2205,9 +1978,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -2258,9 +2028,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -2308,9 +2075,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -2363,9 +2127,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -2416,9 +2177,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -2470,9 +2228,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -2664,9 +2419,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -2717,9 +2469,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -2771,9 +2520,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -2821,9 +2567,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -2874,9 +2617,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -2927,9 +2667,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -2980,9 +2717,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -3033,9 +2767,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -3086,9 +2817,6 @@ This member is an explicit interface member implementation. It can be used only This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -3135,9 +2863,6 @@ If you need to perform multiple operations on an immutable collection, to increa This is an O(1) operation and results in only a single (small) memory allocation. The mutable collection that is returned is not thread safe. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -3190,9 +2915,6 @@ If you need to perform multiple operations on an immutable collection, to increa This can be useful when you want to reuse a previously stored reference instead of a newly constructed one (so that more sharing of references can occur) or to look up a value that has more complete data than the value you currently have, although their comparer functions indicate they are equal. -[System.Collections.Immutable NuGet package](https://www.nuget.org/packages/System.Collections.Immutable/) - -[About immutable collections and how to install](https://learn.microsoft.com/dotnet/api/system.collections.immutable?#remarks) ]]> @@ -3233,17 +2955,7 @@ This can be useful when you want to reuse a previously stored reference instead The items to add. Adds a given set of items to this immutable sorted set. The new set with the items added; or the original set if all the items were already in the set. - - - + To be added. @@ -3289,17 +3001,7 @@ This can be useful when you want to reuse a previously stored reference instead The comparer to check for. Returns the immutable sorted set that has the specified key comparer. The immutable sorted set that has the specified key comparer. - - - + To be added. diff --git a/xml/System.Collections.Immutable/ImmutableStack.xml b/xml/System.Collections.Immutable/ImmutableStack.xml index 2f42cfabaa8..aa459341b88 100644 --- a/xml/System.Collections.Immutable/ImmutableStack.xml +++ b/xml/System.Collections.Immutable/ImmutableStack.xml @@ -35,9 +35,7 @@ - Provides a set of initialization methods for instances of the class. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Provides a set of initialization methods for instances of the class. To be added. This type is thread safe. diff --git a/xml/System.Collections.Immutable/ImmutableStack`1+Enumerator.xml b/xml/System.Collections.Immutable/ImmutableStack`1+Enumerator.xml index c0c1b5bef3f..23031ea5613 100644 --- a/xml/System.Collections.Immutable/ImmutableStack`1+Enumerator.xml +++ b/xml/System.Collections.Immutable/ImmutableStack`1+Enumerator.xml @@ -49,9 +49,7 @@ - Enumerates the contents of an immutable stack without allocating any memory. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Enumerates the contents of an immutable stack without allocating any memory. To be added. This type is thread safe. diff --git a/xml/System.Collections.Immutable/ImmutableStack`1.xml b/xml/System.Collections.Immutable/ImmutableStack`1.xml index 106fd1d7c79..efaaf882490 100644 --- a/xml/System.Collections.Immutable/ImmutableStack`1.xml +++ b/xml/System.Collections.Immutable/ImmutableStack`1.xml @@ -77,9 +77,7 @@ The type of element on the stack. - Represents an immutable stack. - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + Represents an immutable stack. To be added. This type is thread safe. diff --git a/xml/System.Linq/ImmutableArrayExtensions.xml b/xml/System.Linq/ImmutableArrayExtensions.xml index bbbddc17933..6c6ca731fae 100644 --- a/xml/System.Linq/ImmutableArrayExtensions.xml +++ b/xml/System.Linq/ImmutableArrayExtensions.xml @@ -35,9 +35,7 @@ - LINQ extension method overrides that offer greater efficiency for than the standard LINQ methods - - **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) + LINQ extension method overrides that offer greater efficiency for than the standard LINQ methods To be added. diff --git a/xml/ns-System.Collections.Immutable.xml b/xml/ns-System.Collections.Immutable.xml index 4f209e8aa0b..a2d5b1065ae 100644 --- a/xml/ns-System.Collections.Immutable.xml +++ b/xml/ns-System.Collections.Immutable.xml @@ -13,8 +13,6 @@ With immutable collections, you can: - Follow functional programming practices. - Modify a collection during enumeration, while ensuring that the original collection does not change. -The immutable collection classes are available as part of the core .NET libraries, however they're not part of the core class library distributed with .NET Framework. For .NET Framework 4.6.2 and later apps, the classes are available through NuGet packages. - ]]> From 2c1e1b1762b82b3f9a70e95410d1ff017d5d3818 Mon Sep 17 00:00:00 2001 From: Jeff Handley Date: Fri, 20 Feb 2026 18:44:23 -0800 Subject: [PATCH 2/2] Remove remaining NuGet package references from API docs Remove NuGet references from: - System.Configuration/ConfigurationBuilder.xml (NuGet.org package list) - System.Net.Http/HttpClientHandler.xml (NuGet package version notes) - System.Net.Http/WinHttpHandler.xml (NuGet package availability) - ns-System.Net.Http.xml (NuGet packages TIP callout) - Microsoft.Extensions.AI.Evaluation/EvaluationContext.xml (Reporting package reference) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .../EvaluationContext.xml | 7 ++----- xml/System.Configuration/ConfigurationBuilder.xml | 9 +-------- xml/System.Net.Http/HttpClientHandler.xml | 4 ---- xml/System.Net.Http/WinHttpHandler.xml | 2 -- xml/ns-System.Net.Http.xml | 3 --- 5 files changed, 3 insertions(+), 22 deletions(-) diff --git a/xml/Microsoft.Extensions.AI.Evaluation/EvaluationContext.xml b/xml/Microsoft.Extensions.AI.Evaluation/EvaluationContext.xml index c7853a9c061..ac602cc43d1 100644 --- a/xml/Microsoft.Extensions.AI.Evaluation/EvaluationContext.xml +++ b/xml/Microsoft.Extensions.AI.Evaluation/EvaluationContext.xml @@ -56,8 +56,7 @@ This is because an can (optionally) choose to record any s that it used, in the property of each that it - produces. When s are serialized (for example, as part of the result storage and - report generation functionality available in the Microsoft.Extensions.AI.Evaluation.Reporting NuGet package), the + produces. When s are serialized, the s recorded within the will also be serialized. However, for each such , only the information captured within will be serialized. Any information that is (only) present in custom derived @@ -201,9 +200,7 @@ This is because an can (optionally) choose to record any s that it used, in the property of each - that it produces. When s are serialized (for - example, as part of the result storage and report generation functionality available in the - Microsoft.Extensions.AI.Evaluation.Reporting NuGet package), the s recorded + that it produces. When s are serialized, the s recorded within the will also be serialized. However, for each such , only the information captured within will be serialized. Any information that is (only) present in custom derived properties will not be serialized. diff --git a/xml/System.Configuration/ConfigurationBuilder.xml b/xml/System.Configuration/ConfigurationBuilder.xml index 33b082ec451..44d927a6eb4 100644 --- a/xml/System.Configuration/ConfigurationBuilder.xml +++ b/xml/System.Configuration/ConfigurationBuilder.xml @@ -19,14 +19,7 @@ API. ConfigurationBuilders are available on NuGet.org to read from environment variables, Azure key vault, and a number of other sources. - - Several implementations of ConfigurationBuilders are available from NuGet.org: - - - [EnvironmentConfigBuilder](https://www.nuget.org/packages/Microsoft.Configuration.ConfigurationBuilders.Environment/) - Read from environment variables. - - [AzureKeyVaultConfigBuilder](https://www.nuget.org/packages/Microsoft.Configuration.ConfigurationBuilders.Azure/) - Read from Azure Key Vault. - - [UserSecretsConfigBuilder](https://www.nuget.org/packages/Microsoft.Configuration.ConfigurationBuilders.UserSecrets/) - Read from a usersecrets file on disk, similar to the ASP.NET Core functionality. - - [SimpleJsonConfigBuilder](https://www.nuget.org/packages/Microsoft.Configuration.ConfigurationBuilders.Json/) - Read from a JSON file. + Derive from this class to read configuration from an external source that you would like to consume in your .NET Framework application using the standard API. ## Examples The following example shows how to implement a simple ConfigurationBuilder to read Environment variables: diff --git a/xml/System.Net.Http/HttpClientHandler.xml b/xml/System.Net.Http/HttpClientHandler.xml index dcf946444ec..259d6c6b867 100644 --- a/xml/System.Net.Http/HttpClientHandler.xml +++ b/xml/System.Net.Http/HttpClientHandler.xml @@ -202,10 +202,6 @@ For the .NET Framework 4.x `System.Net.Http` binary in the Global Assembly Cache (GAC), the default value is . -When the [`System.Net.Http` NuGet package](https://www.nuget.org/packages/System.Net.Http/) v4.1.0 to v4.3.2 is used, the default is and . - -After NuGet package v4.3.2, the default value of is used. - ]]> diff --git a/xml/System.Net.Http/WinHttpHandler.xml b/xml/System.Net.Http/WinHttpHandler.xml index d7b2caef659..2fb1dc5049b 100644 --- a/xml/System.Net.Http/WinHttpHandler.xml +++ b/xml/System.Net.Http/WinHttpHandler.xml @@ -54,8 +54,6 @@ When using a chain of multiple handlers, should be at the bottom of the chain. -This class is also available for use in Desktop apps by installing it as a NuGet package. For more information, see [System.Net.Http.WinHttpHandler NuGet package](https://www.nuget.org/packages/System.Net.Http.WinHttpHandler/). - Starting in .NET 5, is no longer included in the *System.Net.Http.dll* assembly as part of the .NET runtime. For more information, see [WinHttpHandler removed from .NET runtime](/dotnet/core/compatibility/3.1-5.0#winhttphandler-removed-from-net-runtime). ### Trailing headers diff --git a/xml/ns-System.Net.Http.xml b/xml/ns-System.Net.Http.xml index bf2da35abf0..a30f05a5866 100644 --- a/xml/ns-System.Net.Http.xml +++ b/xml/ns-System.Net.Http.xml @@ -6,9 +6,6 @@ ## Remarks -> [!TIP] -> Some of the types in this namespace are built into .NET, and some are provided through NuGet packages. This page only shows the types for the selected version. There might be other types available in other versions (for example, the corresponding "package-provided" version). - The namespace is designed to provide the following components: - HTTP client components that allow users to consume modern web services over HTTP.