Remove .NET Framework remarks (System.Xml and System.Xaml)

xml/System.Xaml.Permissions/XamlLoadPermission.xml

@@ -55,8 +55,6 @@
 
 [!INCLUDE[cas-deprecated](~/includes/cas-deprecated.md)]
 
- <xref:System.Xaml.Permissions.XamlLoadPermission> is relevant for scenarios such as whether internal types are permitted to load under partial trust.
-
  ]]></format>
     </remarks>
   </Docs>
@@ -100,14 +98,7 @@
       <Docs>
         <param name="allowedAccess">An enumerable set of specific <see cref="T:System.Xaml.Permissions.XamlAccessLevel" /> values.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Xaml.Permissions.XamlLoadPermission" /> class, using an enumerable set of specific <see cref="T:System.Xaml.Permissions.XamlAccessLevel" /> values.</summary>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- A call to this constructor initializes the <xref:System.Xaml.Permissions.XamlLoadPermission.AllowedAccess> collection with each `allowedAccess` entry as an item, and sets the return for <xref:System.Xaml.Permissions.XamlLoadPermission.IsUnrestricted*> to `false` in the created instance.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="allowedAccess" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -144,14 +135,7 @@
       <Docs>
         <param name="state">A <see cref="T:System.Security.Permissions.PermissionState" /> enumeration value.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Xaml.Permissions.XamlLoadPermission" /> class, using existing permissions.</summary>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- <xref:System.Security.Permissions.PermissionState.Unrestricted> sets the return for <xref:System.Xaml.Permissions.XamlLoadPermission.IsUnrestricted*> to `true` in the created instance. Any call to this constructor sets the <xref:System.Xaml.Permissions.XamlLoadPermission.AllowedAccess> collection to `null` because it is not relevant if permissions are being reported rather than <xref:System.Xaml.Permissions.XamlAccessLevel>.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -184,14 +168,7 @@
       <Docs>
         <param name="allowedAccess">The defining <see cref="T:System.Xaml.Permissions.XamlAccessLevel" /> value.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Xaml.Permissions.XamlLoadPermission" /> class, using a single <see cref="T:System.Xaml.Permissions.XamlAccessLevel" /> value.</summary>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- A call to this constructor initializes the <xref:System.Xaml.Permissions.XamlLoadPermission.AllowedAccess> collection with `allowedAccess` as the only item, and sets the return for <xref:System.Xaml.Permissions.XamlLoadPermission.IsUnrestricted*> to `false` in the created instance.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="allowedAccess" /> is <see langword="null" />.</exception>
       </Docs>
@@ -232,14 +209,7 @@
       <Docs>
         <summary>Gets the list of all <see cref="T:System.Xaml.Permissions.XamlAccessLevel" /> values that this <see cref="T:System.Xaml.Permissions.XamlLoadPermission" /> represents.</summary>
         <value>A read-only list of <see cref="T:System.Xaml.Permissions.XamlAccessLevel" /> values, or <see langword="null" />.</value>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- If the current <xref:System.Xaml.Permissions.XamlLoadPermission> is initialized such that <xref:System.Xaml.Permissions.XamlLoadPermission.IsUnrestricted*> is `true`, <xref:System.Xaml.Permissions.XamlLoadPermission.AllowedAccess> may be `null`.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Copy">
@@ -273,14 +243,7 @@
       <Docs>
         <summary>Creates and returns an identical copy of the current <see cref="T:System.Xaml.Permissions.XamlLoadPermission" />.</summary>
         <returns>A copy of the current <see cref="T:System.Xaml.Permissions.XamlLoadPermission" />.</returns>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- Per the interface contract of <xref:System.Security.IPermission> this value is <xref:System.Security.IPermission> in the signature but can be cast to <xref:System.Xaml.Permissions.XamlLoadPermission>.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Equals">
@@ -484,14 +447,7 @@
         <param name="target">A <see cref="T:System.Xaml.Permissions.XamlLoadPermission" /> to intersect with the current <see cref="T:System.Xaml.Permissions.XamlLoadPermission" />. Can be <see langword="null" />.</param>
         <summary>Creates and returns a <see cref="T:System.Xaml.Permissions.XamlLoadPermission" /> that is the intersection of the current <see cref="T:System.Xaml.Permissions.XamlLoadPermission" /> and the specified permission.</summary>
         <returns>A new permission that represents the intersection of the current <see cref="T:System.Xaml.Permissions.XamlLoadPermission" /> and the specified <see cref="T:System.Xaml.Permissions.XamlLoadPermission" />. This new permission is <see langword="null" /> if the intersection is empty.</returns>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- For union, intersect, and subset logic, <xref:System.Xaml.Permissions.XamlLoadPermission.IsUnrestricted*> is checked first, and might return a result based solely on that check. Next, <xref:System.Xaml.Permissions.XamlLoadPermission.AllowedAccess> is checked.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentException">
           <paramref name="target" /> is not <see langword="null" /> or is not a <see cref="T:System.Xaml.Permissions.XamlLoadPermission" />.</exception>
       </Docs>
@@ -531,16 +487,7 @@
         <summary>Determines whether the current <see cref="T:System.Xaml.Permissions.XamlLoadPermission" /> is a subset of the specified permission.</summary>
         <returns>
           <see langword="true" /> if the current <see cref="T:System.Xaml.Permissions.XamlLoadPermission" /> is a subset of the specified permission; otherwise, <see langword="false" />.</returns>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- For union, intersect, and subset logic, <xref:System.Xaml.Permissions.XamlLoadPermission.IsUnrestricted*> is checked first, and might return a result based solely on that check. Next, <xref:System.Xaml.Permissions.XamlLoadPermission.AllowedAccess> is checked.
-
- If `target` is `null` and the current <xref:System.Xaml.Permissions.XamlLoadPermission> is both <xref:System.Xaml.Permissions.XamlLoadPermission.IsUnrestricted*> `false` and has an empty <xref:System.Xaml.Permissions.XamlLoadPermission.AllowedAccess> list, this method returns `true`.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentException">
           <paramref name="target" /> is not <see langword="null" /> or is not a <see cref="T:System.Xaml.Permissions.XamlLoadPermission" />.</exception>
       </Docs>
@@ -651,16 +598,7 @@
         <param name="other">A <see cref="T:System.Xaml.Permissions.XamlLoadPermission" /> to combine with the current <see cref="T:System.Xaml.Permissions.XamlLoadPermission" />. Can be <see langword="null" />.</param>
         <summary>Creates a permission that is the union of the current <see cref="T:System.Xaml.Permissions.XamlLoadPermission" /> and the specified permission.</summary>
         <returns>A new <see cref="T:System.Xaml.Permissions.XamlLoadPermission" /> that represents the union of the current <see cref="T:System.Xaml.Permissions.XamlLoadPermission" /> and the specified <see cref="T:System.Xaml.Permissions.XamlLoadPermission" />.</returns>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- For union, intersect, and subset logic, <xref:System.Xaml.Permissions.XamlLoadPermission.IsUnrestricted*> is checked first, and might return a result based solely on that check. Next, <xref:System.Xaml.Permissions.XamlLoadPermission.AllowedAccess> is checked.
-
- If `other` is `null`, the current <xref:System.Xaml.Permissions.XamlLoadPermission> is returned.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentException">
           <paramref name="other" /> is not <see langword="null" /> or is not a <see cref="T:System.Xaml.Permissions.XamlLoadPermission" />.</exception>
       </Docs>

xml/System.Xaml/XamlObjectWriter.xml

@@ -461,7 +461,7 @@
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
- XAML schema context is a necessary information source for most practical object-writing scenarios. The XAML schema context influences the type lookup for backing types and holds information about the assemblies where backing types exist. The default XAML schema context is based on CLR type-mapping rules. Frameworks typically provide their own XAML schema context in order to assure that the assembly-loading mechanisms match the framework's programming amd application models.
+ XAML schema context is a necessary information source for most practical object-writing scenarios. The XAML schema context influences the type lookup for backing types and holds information about the assemblies where backing types exist. The default XAML schema context is based on CLR type-mapping rules. Frameworks typically provide their own XAML schema context in order to assure that the assembly-loading mechanisms match .NET's programming and application models.
 
  ]]></format>
         </remarks>

xml/System.Xaml/XamlObjectWriterSettings.xml

@@ -122,14 +122,7 @@
       <Docs>
         <summary>Gets or sets <see cref="T:System.Xaml.Permissions.XamlAccessLevel" /> permissions that the XAML writer observes.</summary>
         <value>The <see cref="T:System.Xaml.Permissions.XamlAccessLevel" /> permissions.</value>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- This property indicates the expected access level for non-public members, which are accessed in partial trust through a partial-trust tolerant runtime.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="AfterBeginInitHandler">

xml/System.Xaml/XamlSchemaContext.xml

@@ -30,13 +30,6 @@
 
  ]]></format>
     </remarks>
-    <block subset="none" type="overrides">
-      <para>In an <see cref="T:System.AppDomain" />, a <see cref="T:System.Xaml.XamlSchemaContext" /> can be shared between multiple callers, which include both full and partial trust callers. This situation exists in frameworks such as WPF, which provide partial-trust access to XAML loading for portions of the WPF application model. The default <see cref="T:System.Xaml.XamlSchemaContext" /> implementation provides safeguards in this scenario by keeping all its properties and settings immutable. Derived implementations should also consider following this model of immutability for properties and settings of a XAML schema context.
-
- The <see cref="T:System.Xaml.XamlSchemaContext" /> base class is designed so that lookups have no externally observable side effects. The types that are referenced by <see cref="T:System.Xaml.XamlSchemaContext" /> APIs in the base class, such as <see cref="T:System.Xaml.XamlType" /> or <see cref="T:System.Xaml.XamlMember" />, also produce no side effects from lookups. All data that is needed to make a schema determination should be available from the construction and settings of the <see cref="T:System.AppDomain" />. Notice that no lookup APIs rely on explicitly passed-in services; their input relies on string input only.
-
- The <see cref="T:System.Xaml.XamlSchemaContext" /> base class, and <see cref="T:System.Xaml.XamlType" /> and <see cref="T:System.Xaml.XamlMember" /> are all thread safe in their base implementations. If you derive from <see cref="T:System.Xaml.XamlSchemaContext" /> or derive XAML type system classes such as <see cref="T:System.Xaml.XamlType" /> and <see cref="T:System.Xaml.XamlMember" /> , you can choose whether your classes will behave as thread safe.</para>
-    </block>
   </Docs>
   <Members>
     <MemberGroup MemberName=".ctor">

xml/System.Xml.Resolvers/XmlPreloadedResolver.xml

@@ -585,7 +585,7 @@
       </Parameters>
       <Docs>
         <param name="absoluteUri">The URI returned from <see cref="M:System.Xml.XmlResolver.ResolveUri(System.Uri,System.String)" />.</param>
-        <param name="role">The current version of the .NET Framework for Silverlight does not use this parameter when resolving URIs. This parameter is provided for future extensibility purposes. For example, this parameter can be mapped to the xlink:role and used as an implementation-specific argument in other scenarios.</param>
+        <param name="role">This parameter is provided for future extensibility purposes. For example, this parameter can be mapped to the xlink:role and used as an implementation-specific argument in other scenarios.</param>
         <param name="ofObjectToReturn">The type of object to return. The <see cref="T:System.Xml.Resolvers.XmlPreloadedResolver" /> supports <see cref="T:System.IO.Stream" /> objects and <see cref="T:System.IO.TextReader" /> objects for URIs that were added as <see langword="String" />. If the requested type is not supported by the resolver, an exception will be thrown. Use the <see cref="M:System.Xml.Resolvers.XmlPreloadedResolver.SupportsType(System.Uri,System.Type)" /> method to determine whether a certain <see langword="Type" /> is supported by this resolver.</param>
         <summary>Maps a URI to an object that contains the actual resource.</summary>
         <returns>A <see cref="T:System.IO.Stream" /> or <see cref="T:System.IO.TextReader" /> object that corresponds to the actual source.</returns>
@@ -662,7 +662,7 @@
       </Parameters>
       <Docs>
         <param name="absoluteUri">The URI returned from <see cref="M:System.Xml.XmlResolver.ResolveUri(System.Uri,System.String)" />.</param>
-        <param name="role">The current version of the .NET Framework for Silverlight does not use this parameter when resolving URIs. This parameter is provided for future extensibility purposes. For example, this parameter can be mapped to the xlink:role and used as an implementation-specific argument in other scenarios.</param>
+        <param name="role">This parameter is provided for future extensibility purposes. For example, this parameter can be mapped to the xlink:role and used as an implementation-specific argument in other scenarios.</param>
         <param name="ofObjectToReturn">The type of object to return. The <see cref="T:System.Xml.Resolvers.XmlPreloadedResolver" /> supports <see cref="T:System.IO.Stream" /> objects and <see cref="T:System.IO.TextReader" /> objects for URIs that were added as <see langword="String" />. If the requested type is not supported by the resolver, an exception will be thrown. Use the <see cref="M:System.Xml.Resolvers.XmlPreloadedResolver.SupportsType(System.Uri,System.Type)" /> method to determine whether a certain <see langword="Type" /> is supported by this resolver.</param>
         <summary>Asynchronously maps a URI to an object that contains the actual resource.</summary>
         <returns>A <see cref="T:System.IO.Stream" /> or <see cref="T:System.IO.TextReader" /> object that corresponds to the actual source.</returns>

xml/System.Xml.Schema/XmlSchema.xml

@@ -446,16 +446,7 @@
       <Docs>
         <param name="validationEventHandler">The validation event handler that receives information about XML Schema validation errors.</param>
         <summary>Compiles the XML Schema Object Model (SOM) into schema information for validation. Used to check the syntactic and semantic structure of the programmatically built SOM. Semantic validation checking is performed during compilation.</summary>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
-
-> [!IMPORTANT]
-> The <xref:System.Xml.Schema.XmlSchema.Compile*> method is obsolete in the Microsoft .NET Framework version 2.0 and has been replaced by the <xref:System.Xml.Schema.XmlSchemaSet.Compile*?displayProperty=nameWithType> method.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Compile">
@@ -517,20 +508,7 @@
         <param name="validationEventHandler">The validation event handler that receives information about the XML Schema validation errors.</param>
         <param name="resolver">The <see langword="XmlResolver" /> used to resolve namespaces referenced in <see langword="include" /> and <see langword="import" /> elements.</param>
         <summary>Compiles the XML Schema Object Model (SOM) into schema information for validation. Used to check the syntactic and semantic structure of the programmatically built SOM. Semantic validation checking is performed during compilation.</summary>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- If the SOM references other namespaces through the `import` or `include` elements, the `XmlResolver` is used to resolve these references. If the resolver is set to `null`, this indicates that the user does not care about resolving `import` or `include` elements. In this case, the references are not resolved. The resolver is not cached after the `Compile` method completes.
-
-> [!IMPORTANT]
-> The <xref:System.Xml.Schema.XmlSchema.Compile*> method is obsolete in the Microsoft .NET Framework version 2.0 and has been replaced by the <xref:System.Xml.Schema.XmlSchemaSet.Compile*?displayProperty=nameWithType> method.
-
-> [!IMPORTANT]
-> The <xref:System.Xml.Schema.XmlSchema.Compile*> method uses the <xref:System.Xml.XmlUrlResolver> class to resolve external schemas referenced in include, import, or redefine elements by default. You can disable resolution of external schemas by passing null as the <xref:System.Xml.XmlResolver> parameter.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="ElementFormDefault">

xml/System.Xml.Schema/XmlSchemaAttribute.xml

@@ -224,17 +224,7 @@
       <Docs>
         <summary>Gets the common language runtime (CLR) object based on the <see cref="P:System.Xml.Schema.XmlSchemaAttribute.SchemaType" /> or <see cref="P:System.Xml.Schema.XmlSchemaAttribute.SchemaTypeName" /> of the attribute that holds the post-compilation value of the <see langword="AttributeType" /> property.</summary>
         <value>The common runtime library (CLR) object that holds the post-compilation value of the <see langword="AttributeType" /> property.</value>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- The object can be <xref:System.Xml.Schema.XmlSchemaDatatype> if the attribute has a built-in XML Schema type or <xref:System.Xml.Schema.XmlSchemaSimpleType> if the attribute has a user-defined type. This property is a post-schema-validation infoset property.
-
-> [!IMPORTANT]
-> The <xref:System.Xml.Schema.XmlSchemaAttribute.AttributeType> property is obsolete in the 2.0 version of the .NET Framework and has been replaced by the <xref:System.Xml.Schema.XmlSchemaAttribute.AttributeSchemaType> property.
-
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="DefaultValue">