Add note about deprecation of System.Json (dotnet#8111)

Author: gewarren

includes/system-json.md

@@ -0,0 +1,2 @@
+> [!NOTE]
+> The <xref:System.Json?displayProperty=fullName> namespace was designed for Silverlight, which is no longer supported. For processing JSON, we recommend using APIs in the <xref:System.Text.Json> namespace instead.

xml/System.Json/JsonArray.xml

@@ -38,7 +38,13 @@
   </Interfaces>
   <Docs>
     <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
+
+## Remarks
+
+[!INCLUDE[system-json](~/includes/system-json.md)]
+
+</remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
@@ -63,7 +69,13 @@
       <Docs>
         <param name="items">To be added.</param>
         <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+
+## Remarks
+
+[!INCLUDE[system-json](~/includes/system-json.md)]
+
+</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -95,7 +107,13 @@
       <Docs>
         <param name="items">To be added.</param>
         <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+
+## Remarks
+
+[!INCLUDE[system-json](~/includes/system-json.md)]
+
+</remarks>
       </Docs>
     </Member>
     <Member MemberName="Add">
@@ -126,7 +144,13 @@
       <Docs>
         <param name="item">The object to add to the <see cref="T:System.Collections.Generic.ICollection`1" />.</param>
         <summary>Adds an item to the <see cref="T:System.Collections.Generic.ICollection`1" />.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+
+## Remarks
+
+[!INCLUDE[system-json](~/includes/system-json.md)]
+
+</remarks>
       </Docs>
     </Member>
     <Member MemberName="AddRange">
@@ -154,7 +178,13 @@
       <Docs>
         <param name="items">To be added.</param>
         <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+
+## Remarks
+
+[!INCLUDE[system-json](~/includes/system-json.md)]
+
+</remarks>
       </Docs>
     </Member>
     <Member MemberName="AddRange">
@@ -189,7 +219,13 @@
       <Docs>
         <param name="items">To be added.</param>
         <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+
+## Remarks
+
+[!INCLUDE[system-json](~/includes/system-json.md)]
+
+</remarks>
       </Docs>
     </Member>
     <Member MemberName="Clear">
@@ -217,7 +253,13 @@
       <Parameters />
       <Docs>
         <summary>Removes all items from the <see cref="T:System.Collections.Generic.ICollection`1" />.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+
+## Remarks
+
+[!INCLUDE[system-json](~/includes/system-json.md)]
+
+</remarks>
       </Docs>
     </Member>
     <Member MemberName="Contains">
@@ -250,7 +292,13 @@
         <summary>Determines whether the <see cref="T:System.Collections.Generic.ICollection`1" /> contains a specific value.</summary>
         <returns>
           <see langword="true" /> if <paramref name="item" /> is found in the <see cref="T:System.Collections.Generic.ICollection`1" />; otherwise, <see langword="false" />.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
+
+## Remarks
+
+[!INCLUDE[system-json](~/includes/system-json.md)]
+
+</remarks>
       </Docs>
     </Member>
     <Member MemberName="CopyTo">
@@ -283,7 +331,13 @@
         <param name="array">The one-dimensional <see cref="T:System.Array" /> that is the destination of the elements copied from <see cref="T:System.Collections.Generic.ICollection`1" />. The <see cref="T:System.Array" /> must have zero-based indexing.</param>
         <param name="arrayIndex">The zero-based index in <paramref name="array" /> at which copying begins.</param>
         <summary>Copies the elements of the <see cref="T:System.Collections.Generic.ICollection`1" /> to an <see cref="T:System.Array" />, starting at a particular <see cref="T:System.Array" /> index.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+
+## Remarks
+
+[!INCLUDE[system-json](~/includes/system-json.md)]
+
+</remarks>
       </Docs>
     </Member>
     <Member MemberName="Count">
@@ -311,7 +365,13 @@
       <Docs>
         <summary>Gets the number of elements contained in the <see cref="T:System.Collections.Generic.ICollection`1" />.</summary>
         <value>The number of elements contained in the <see cref="T:System.Collections.Generic.ICollection`1" />.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+
+## Remarks
+
+[!INCLUDE[system-json](~/includes/system-json.md)]
+
+</remarks>
       </Docs>
     </Member>
     <Member MemberName="IndexOf">
@@ -343,7 +403,13 @@
         <param name="item">The object to locate in the <see cref="T:System.Collections.Generic.IList`1" />.</param>
         <summary>Determines the index of a specific item in the <see cref="T:System.Collections.Generic.IList`1" />.</summary>
         <returns>The index of <paramref name="item" /> if found in the list; otherwise, -1.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
+
+## Remarks
+
+[!INCLUDE[system-json](~/includes/system-json.md)]
+
+</remarks>
       </Docs>
     </Member>
     <Member MemberName="Insert">
@@ -376,7 +442,13 @@
         <param name="index">The zero-based index at which <paramref name="item" /> should be inserted.</param>
         <param name="item">The object to insert into the <see cref="T:System.Collections.Generic.IList`1" />.</param>
         <summary>Inserts an item to the <see cref="T:System.Collections.Generic.IList`1" /> at the specified index.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+
+## Remarks
+
+[!INCLUDE[system-json](~/includes/system-json.md)]
+
+</remarks>
       </Docs>
     </Member>
     <Member MemberName="IsReadOnly">
@@ -405,7 +477,13 @@
         <summary>Gets a value indicating whether the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only.</summary>
         <value>
           <see langword="true" /> if the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only; otherwise, <see langword="false" />.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+
+## Remarks
+
+[!INCLUDE[system-json](~/includes/system-json.md)]
+
+</remarks>
       </Docs>
     </Member>
     <Member MemberName="Item">
@@ -437,7 +515,13 @@
         <param name="index">The zero-based index of the element to get or set.</param>
         <summary>Gets or sets the element at the specified index.</summary>
         <value>The element at the specified index.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+
+## Remarks
+
+[!INCLUDE[system-json](~/includes/system-json.md)]
+
+</remarks>
       </Docs>
     </Member>
     <Member MemberName="JsonType">
@@ -462,7 +546,13 @@
       <Docs>
         <summary>To be added.</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+
+## Remarks
+
+[!INCLUDE[system-json](~/includes/system-json.md)]
+
+</remarks>
       </Docs>
     </Member>
     <Member MemberName="Remove">
@@ -495,7 +585,13 @@
         <summary>Removes the first occurrence of a specific object from the <see cref="T:System.Collections.Generic.ICollection`1" />.</summary>
         <returns>
           <see langword="true" /> if <paramref name="item" /> was successfully removed from the <see cref="T:System.Collections.Generic.ICollection`1" />; otherwise, <see langword="false" />. This method also returns <see langword="false" /> if <paramref name="item" /> is not found in the original <see cref="T:System.Collections.Generic.ICollection`1" />.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
+
+## Remarks
+
+[!INCLUDE[system-json](~/includes/system-json.md)]
+
+</remarks>
       </Docs>
     </Member>
     <Member MemberName="RemoveAt">
@@ -526,7 +622,13 @@
       <Docs>
         <param name="index">The zero-based index of the item to remove.</param>
         <summary>Removes the <see cref="T:System.Collections.Generic.IList`1" /> item at the specified index.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+
+## Remarks
+
+[!INCLUDE[system-json](~/includes/system-json.md)]
+
+</remarks>
       </Docs>
     </Member>
     <Member MemberName="Save">
@@ -554,7 +656,13 @@
       <Docs>
         <param name="stream">To be added.</param>
         <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+
+## Remarks
+
+[!INCLUDE[system-json](~/includes/system-json.md)]
+
+</remarks>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.Generic.IEnumerable&lt;System.Json.JsonValue&gt;.GetEnumerator">
@@ -583,7 +691,13 @@
       <Docs>
         <summary>Returns an enumerator that iterates through the collection.</summary>
         <returns>An enumerator that can be used to iterate through the collection.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
+
+## Remarks
+
+[!INCLUDE[system-json](~/includes/system-json.md)]
+
+</remarks>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IEnumerable.GetEnumerator">