Replaced dropped text, fixed some formatting (dotnet#3001)

* Replaced dropped text, fixed some formatting

* Additional changes

* Update xml/System/InvalidOperationException.xml

Co-Authored-By: Maira Wenzel <[email protected]>

Author: Ron Petrusha

xml/System.Collections.Generic/IList`1.xml

@@ -201,7 +201,7 @@
 ## Remarks  
  This property provides the ability to access a specific element in the collection by using the following syntax: `myCollection[index]`.  
   
- The C# language uses the  keyword to define the indexers instead of implementing the <xref:System.Collections.Generic.IList%601.Item%2A> property. Visual Basic implements <xref:System.Collections.Generic.IList%601.Item%2A> as a default property, which provides the same indexing functionality.  
+ The C# language uses the [this](~/docs/csharp/language-reference/keywords/this.md) keyword to define the indexers instead of implementing the <xref:System.Collections.Generic.IList%601.Item%2A> property. Visual Basic implements <xref:System.Collections.Generic.IList%601.Item%2A> as a [default property](~/docs/visual-basic/language-reference/modifiers/default.md), which provides the same indexing functionality.  
   
  ]]></format>
         </remarks>

xml/System.Collections.Generic/SortedDictionary`2+ValueCollection+Enumerator.xml

@@ -47,7 +47,7 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The `foreach` statement of the C# (`for each` in C++, `For Each` in Visual Basic) hides the complexity of enumerators.  Therefore, using `foreach` is recommended, instead of directly manipulating the enumerator. This type implements the  
+ The `foreach` statement of the C# (`for each` in C++, `For Each` in Visual Basic) hides the complexity of enumerators.  Therefore, using `foreach` is recommended, instead of directly manipulating the enumerator. This type implements the <xref:System.Collections.Generic.IEnumerator%601> interface. 
   
  Enumerators can be used to read the data in the collection, but they cannot be used to modify the underlying collection.  
   

xml/System.Collections.Immutable/ImmutableInterlocked.xml

@@ -656,8 +656,7 @@
         <param name="location">The variable or field to be changed, which may be accessed by multiple threads.</param>
         <param name="transformer">A function that mutates the value. This function should be side-effect free,              as it may run multiple times when races occur with other threads.</param>
         <summary>Mutates a value in-place with optimistic locking transaction semantics             via a specified transformation function.             The transformation is retried as many times as necessary to win the optimistic locking race.</summary>
-        <returns>
-          <c>true</c> if the location's value is changed by applying the result of the              <paramref name="transformer" /> function;             <c>false</c> if the location's value remained the same because the last              invocation of <paramref name="transformer" /> returned the existing value.</returns>
+        <returns><see langword="true" /> if the location's value is changed by applying the result of the <paramref name="transformer" /> function; <see langword="false" /> if the location's value remained the same because the last invocation of <paramref name="transformer" /> returned the existing value.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -701,8 +700,7 @@
         <param name="transformer">A function that mutates the value. This function should be side-effect free,              as it may run multiple times when races occur with other threads.</param>
         <param name="transformerArgument">The argument to pass to <paramref name="transformer" />.</param>
         <summary>Mutates a value in-place with optimistic locking transaction semantics             via a specified transformation function.             The transformation is retried as many times as necessary to win the optimistic locking race.</summary>
-        <returns>
-          <c>true</c> if the location's value is changed by applying the result of the              <paramref name="transformer" /> function;             <c>false</c> if the location's value remained the same because the last              invocation of <paramref name="transformer" /> returned the existing value.</returns>
+        <returns><see langword="true" /> if the location's value is changed by applying the result of the <paramref name="transformer" /> function; <see langword="false" /> if the location's value remained the same because the last invocation of <paramref name="transformer" /> returned the existing value.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Collections.ObjectModel/KeyedCollection`2.xml

@@ -825,12 +825,10 @@
   
  If the <xref:System.Collections.ObjectModel.KeyedCollection%602> has a lookup dictionary, `key` is used to retrieve the element from the dictionary.  If there is no lookup dictionary, the key of each element is extracted using the <xref:System.Collections.ObjectModel.KeyedCollection%602.GetKeyForItem%2A> method and compared with the specified key.  
   
- The C# language uses the  keyword to define the indexers instead of implementing the <xref:System.Collections.ObjectModel.KeyedCollection%602.Item%2A> property. Visual Basic implements <xref:System.Collections.ObjectModel.KeyedCollection%602.Item%2A> as a default property, which provides the same indexing functionality.  
-  
- Retrieving the value of this property is an O(1) operation if the <xref:System.Collections.ObjectModel.KeyedCollection%602> has a lookup dictionary; otherwise it is an O(`n`) operation, where `n` is <xref:System.Collections.ObjectModel.Collection%601.Count%2A>.  
-  
-   
+ The C# language uses the [this](~/docs/csharp/language-reference/keywords/this.md) keyword to define the indexers instead of implementing the <xref:System.Collections.ObjectModel.KeyedCollection%602.Item%2A> property. Visual Basic implements <xref:System.Collections.ObjectModel.KeyedCollection%602.Item%2A> as a [default property](~/docs/visual-basic/language-reference/modifiers/default.md), which provides the same indexing functionality.  
   
+ Retrieving the value of this property is an O(1) operation if the <xref:System.Collections.ObjectModel.KeyedCollection%602> has a lookup dictionary; otherwise it is an O(`n`) operation, where `n` is <xref:System.Collections.ObjectModel.Collection%601.Count%2A>.
+
 ## Examples  
  This code example shows the minimum code necessary to derive a collection class from <xref:System.Collections.ObjectModel.KeyedCollection%602>: overriding the <xref:System.Collections.ObjectModel.KeyedCollection%602.GetKeyForItem%2A> method and providing a public constructor that delegates to a base class constructor. The code example also demonstrates many of the properties and methods inherited from <xref:System.Collections.ObjectModel.KeyedCollection%602> and <xref:System.Collections.ObjectModel.Collection%601> classes.  
   

xml/System.Collections.Specialized/BitVector32.xml

@@ -663,7 +663,7 @@
   
  A <xref:System.Collections.Specialized.BitVector32.Section> is a window into the <xref:System.Collections.Specialized.BitVector32> and is composed of the smallest number of consecutive bits that can contain the maximum value specified in <xref:System.Collections.Specialized.BitVector32.CreateSection%2A>. For example, a section with a maximum value of 1 is composed of only one bit, whereas a section with a maximum value of 5 is composed of three bits. You can create a <xref:System.Collections.Specialized.BitVector32.Section> with a maximum value of 1 to serve as a Boolean, thereby allowing you to store integers and Booleans in the same <xref:System.Collections.Specialized.BitVector32>.  
   
- The C# language uses the  keyword to define the indexers instead of implementing the <xref:System.Collections.Specialized.BitVector32.Item%2A> property. Visual Basic implements <xref:System.Collections.Specialized.BitVector32.Item%2A> as a default property, which provides the same indexing functionality.  
+ The C# language uses the [this](~/docs/csharp/language-reference/keywords/this.md) keyword to define the indexers instead of implementing the <xref:System.Collections.Specialized.BitVector32.Item%2A> property. Visual Basic implements <xref:System.Collections.Specialized.BitVector32.Item%2A> as a [default property](~/docs/visual-basic/language-reference/modifiers/default.md), which provides the same indexing functionality.  
   
  Retrieving the value of this property is an O(1) operation; setting the property is also an O(1) operation.  
   
@@ -719,7 +719,7 @@
   
  Using this property on a <xref:System.Collections.Specialized.BitVector32> that is set up as sections might cause unexpected results.  
   
- The C# language uses the  keyword to define the indexers instead of implementing the <xref:System.Collections.Specialized.BitVector32.Item%2A> property. Visual Basic implements <xref:System.Collections.Specialized.BitVector32.Item%2A> as a default property, which provides the same indexing functionality.  
+ The C# language uses the [this](~/docs/csharp/language-reference/keywords/this.md) keyword to define the indexers instead of implementing the <xref:System.Collections.Specialized.BitVector32.Item%2A> property. Visual Basic implements <xref:System.Collections.Specialized.BitVector32.Item%2A> as a [default property](~/docs/visual-basic/language-reference/modifiers/default.md), which provides the same indexing functionality.  
   
  Retrieving the value of this property is an O(1) operation; setting the property is also an O(1) operation.  
   

xml/System.Collections.Specialized/IOrderedDictionary.xml

@@ -256,12 +256,13 @@
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
-## Remarks  
- <xref:System.Collections.Specialized.IOrderedDictionary> accepts `null` as a valid value and allows duplicate elements.  
-  
- The C# language uses the  keyword to define the indexers instead of implementing the <xref:System.Collections.Specialized.IOrderedDictionary.Item%2A> property. Visual Basic implements <xref:System.Collections.Specialized.IOrderedDictionary.Item%2A> as a default property, which provides the same indexing functionality.  
-  
- This property allows you to access a specific element in the collection by using the following syntax:  
+## Remarks
+
+<xref:System.Collections.Specialized.IOrderedDictionary> accepts `null` as a valid value and allows duplicate elements.
+
+The C# language uses the [this](~/docs/csharp/language-reference/keywords/this.md) keyword to define the indexers instead of implementing the <xref:System.Collections.Specialized.IOrderedDictionary.Item%2A> property. Visual Basic implements <xref:System.Collections.Specialized.IOrderedDictionary.Item%2A> as a [default property](~/docs/visual-basic/language-reference/modifiers/default.md), which provides the same indexing functionality.
+
+This property allows you to access a specific element in the collection by using the following syntax:  
   
  [!code-cpp[System.Collections.Specialized.IOrderedDictionary_Implementation#04](~/samples/snippets/cpp/VS_Snippets_CLR_System/system.Collections.Specialized.IOrderedDictionary_Implementation/cpp/remarks.cpp#04)]
  [!code-csharp[System.Collections.Specialized.IOrderedDictionary_Implementation#04](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Collections.Specialized.IOrderedDictionary_Implementation/cs/remarks.cs#04)]

xml/System.Collections.Specialized/NameObjectCollectionBase+KeysCollection.xml

@@ -256,7 +256,7 @@
 ## Remarks  
  This property provides the ability to access a specific element in the collection by using the following syntax: `myCollection[index]` (In Visual Basic, `myCollection(index)`).  
   
- The C# language uses the  keyword to define the indexers instead of implementing the <xref:System.Collections.Specialized.NameObjectCollectionBase.KeysCollection.Item%2A> property. Visual Basic implements <xref:System.Collections.Specialized.NameObjectCollectionBase.KeysCollection.Item%2A> as a default property, which provides the same indexing functionality.  
+ The C# language uses the [this](~/docs/csharp/language-reference/keywords/this.md) keyword to define the indexers instead of implementing the <xref:System.Collections.Specialized.NameObjectCollectionBase.KeysCollection.Item%2A> property. Visual Basic implements <xref:System.Collections.Specialized.NameObjectCollectionBase.KeysCollection.Item%2A> as a [default property](~/docs/visual-basic/language-reference/modifiers/default.md), which provides the same indexing functionality.  
   
  Retrieving the value of this property is an O(1) operation; setting the property is also an O(1) operation.  
   

xml/System.Collections.Specialized/NameValueCollection.xml

@@ -1327,7 +1327,7 @@
   
  This property cannot be set. To set the value at a specified index, use `Item[GetKey(index)]`.  
   
- The C# language uses the  keyword to define the indexers instead of implementing the <xref:System.Collections.Specialized.NameValueCollection.Item%2A> property. Visual Basic implements <xref:System.Collections.Specialized.NameValueCollection.Item%2A> as a default property, which provides the same indexing functionality.  
+ The C# language uses the [this](~/docs/csharp/language-reference/keywords/this.md) keyword to define the indexers instead of implementing the <xref:System.Collections.Specialized.NameValueCollection.Item%2A> property. Visual Basic implements <xref:System.Collections.Specialized.NameValueCollection.Item%2A> as a [default property](~/docs/visual-basic/language-reference/modifiers/default.md), which provides the same indexing functionality.  
   
  Retrieving the values at the specified index is an O(`n`) operation, where `n` is the number of values.  
   
@@ -1397,7 +1397,7 @@
 > [!CAUTION]
 >  This property returns `null` in the following cases: 1) if the specified key is not found; and 2) if the specified key is found and its associated value is `null`. This property does not distinguish between the two cases.  
   
- The C# language uses the  keyword to define the indexers instead of implementing the <xref:System.Collections.Specialized.NameValueCollection.Item%2A> property. Visual Basic implements <xref:System.Collections.Specialized.NameValueCollection.Item%2A> as a default property, which provides the same indexing functionality.  
+ The C# language uses the [this](~/docs/csharp/language-reference/keywords/this.md) keyword to define the indexers instead of implementing the <xref:System.Collections.Specialized.NameValueCollection.Item%2A> property. Visual Basic implements <xref:System.Collections.Specialized.NameValueCollection.Item%2A> as a [default property](~/docs/visual-basic/language-reference/modifiers/default.md), which provides the same indexing functionality.  
   
  Retrieving or setting the values associated with the specified key is an O(`n`) operation, where `n` is the number of values.  
   

xml/System.Collections.Specialized/OrderedDictionary.xml

@@ -964,7 +964,7 @@
 ## Remarks  
  This property allows you to access a specific element in the collection by using the following syntax: `myCollection[index]`.  
   
- The C# language uses the  keyword to define the indexers instead of implementing the <xref:System.Collections.Specialized.OrderedDictionary.Item%2A> property. Visual Basic implements <xref:System.Collections.Specialized.OrderedDictionary.Item%2A> as a default property, which provides the same indexing functionality.  
+ The C# language uses the [this](~/docs/csharp/language-reference/keywords/this.md) keyword to define the indexers instead of implementing the <xref:System.Collections.Specialized.OrderedDictionary.Item%2A> property. Visual Basic implements <xref:System.Collections.Specialized.OrderedDictionary.Item%2A> as a [default property](~/docs/visual-basic/language-reference/modifiers/default.md), which provides the same indexing functionality.  
   
  ]]></format>
         </remarks>

xml/System.Collections.Specialized/StringCollection.xml

@@ -837,7 +837,7 @@
   
  <xref:System.Collections.Specialized.StringCollection> accepts `null` as a valid value and allows duplicate elements.  
   
- The C# language uses the  keyword to define the indexers instead of implementing the <xref:System.Collections.Specialized.StringCollection.Item%2A> property. Visual Basic implements <xref:System.Collections.Specialized.StringCollection.Item%2A> as a default property, which provides the same indexing functionality.  
+ The C# language uses the [this](~/docs/csharp/language-reference/keywords/this.md) keyword to define the indexers instead of implementing the <xref:System.Collections.Specialized.StringCollection.Item%2A> property. Visual Basic implements <xref:System.Collections.Specialized.StringCollection.Item%2A> as a [default property](~/docs/visual-basic/language-reference/modifiers/default.md), which provides the same indexing functionality.  
   
  Retrieving the value of this property is an O(1) operation; setting the property is also an O(1) operation.