delete 404 links to samples (#9874)

Author: gewarren

xml/System.IO.Packaging/CertificateEmbeddingOption.xml

@@ -21,26 +21,25 @@
   <Docs>
     <summary>Specifies the location where the X.509 certificate that is used in signing is stored.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- If the certificate is `NotEmbedded` in the package, an application that verifies signatures must provide a copy of the certificate in order to verify the signatures that are signed by it.  
-  
- `InSignaturePart` adds two informational elements, `<KeyName>` and `<KeyValue>`, as part of the <xref:System.Security.Cryptography.Xml.Signature.KeyInfo%2A> field of the stored digital signature. The `<KeyName>` and `<KeyValue>` elements are not processed as part of signature validation and are therefore not secure from modification. Applications should not make any assumption regarding the validity of these two elements. To avoid undetected modification and possible confusion, applications should use the `InCertificatePart` option instead of `InSignaturePart`. The `InCertificatePart` option does not provide or expose either `<KeyName>` or `<KeyValue>`.  
-  
-   
-  
-## Examples  
- The following example shows how to use `CertificateEmbeddingOption` in order to set the <xref:System.IO.Packaging.PackageDigitalSignatureManager.CertificateOption%2A?displayProperty=nameWithType> property.  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+If the certificate is `NotEmbedded` in the package, an application that verifies signatures must provide a copy of the certificate in order to verify the signatures that are signed by it.
+
+`InSignaturePart` adds two informational elements, `<KeyName>` and `<KeyValue>`, as part of the <xref:System.Security.Cryptography.Xml.Signature.KeyInfo%2A> field of the stored digital signature. The `<KeyName>` and `<KeyValue>` elements are not processed as part of signature validation and are therefore not secure from modification. Applications should not make any assumption regarding the validity of these two elements. To avoid undetected modification and possible confusion, applications should use the `InCertificatePart` option instead of `InSignaturePart`. The `InCertificatePart` option does not provide or expose either `<KeyName>` or `<KeyValue>`.
+
+## Examples
+
+The following example shows how to use `CertificateEmbeddingOption` in order to set the <xref:System.IO.Packaging.PackageDigitalSignatureManager.CertificateOption%2A?displayProperty=nameWithType> property.
+
 :::code language="csharp" source="~/snippets/csharp/System.IO.Packaging/CertificateEmbeddingOption/Overview/PackageDigitalSignature.cs" id="SnippetPackageDigSigSign":::
 :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Wpf/PackageDigitalSignature/visualbasic/packagedigitalsignature.vb" id="SnippetPackageDigSigSign":::
-  
+
  ]]></format>
     </remarks>
     <altmember cref="P:System.IO.Packaging.PackageDigitalSignatureManager.CertificateOption" />
     <altmember cref="P:System.IO.Packaging.PackageDigitalSignature.CertificateEmbeddingOption" />
-    <related type="ExternalDocumentation" href="https://go.microsoft.com/fwlink/?LinkID=159966">Creating a Package with a Digital Signature Sample</related>
     <related type="ExternalDocumentation" href="https://www.ecma-international.org/publications-and-standards/standards/ecma-376/">Open Packaging Conventions (OPC) Specification</related>
   </Docs>
   <Members>

xml/System.IO.Packaging/PackUriHelper.xml

@@ -49,19 +49,18 @@
   <Docs>
     <summary>Defines <see cref="T:System.IO.Packaging.PackageRelationship" /> criteria to select part-level or package-level relationships.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- <xref:System.IO.Packaging.PackageRelationshipSelector> is used by the <xref:System.IO.Packaging.PackageDigitalSignatureManager.Sign%2A> method of the <xref:System.IO.Packaging.PackageDigitalSignatureManager> class to specify a list of <xref:System.IO.Packaging.PackageRelationship> parts to be signed.  
-  
- <xref:System.IO.Packaging.PackageRelationshipSelector> is used by the <xref:System.IO.Packaging.PackageDigitalSignature.SignedRelationshipSelectors%2A> property of the <xref:System.IO.Packaging.PackageDigitalSignature> class to obtain a list of <xref:System.IO.Packaging.PackageRelationship> parts that have been signed with the given digital signature.  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ <xref:System.IO.Packaging.PackageRelationshipSelector> is used by the <xref:System.IO.Packaging.PackageDigitalSignatureManager.Sign%2A> method of the <xref:System.IO.Packaging.PackageDigitalSignatureManager> class to specify a list of <xref:System.IO.Packaging.PackageRelationship> parts to be signed.
+
+ <xref:System.IO.Packaging.PackageRelationshipSelector> is used by the <xref:System.IO.Packaging.PackageDigitalSignature.SignedRelationshipSelectors%2A> property of the <xref:System.IO.Packaging.PackageDigitalSignature> class to obtain a list of <xref:System.IO.Packaging.PackageRelationship> parts that have been signed with the given digital signature.
+
  ]]></format>
     </remarks>
     <altmember cref="T:System.IO.Packaging.PackageRelationshipSelectorType" />
     <altmember cref="T:System.IO.Packaging.PackageRelationship" />
     <altmember cref="T:System.IO.Packaging.PackagePart" />
-    <related type="ExternalDocumentation" href="https://go.microsoft.com/fwlink/?LinkID=159966">Creating a Package with a Digital Signature Sample</related>
     <related type="ExternalDocumentation" href="https://www.ecma-international.org/publications-and-standards/standards/ecma-376/">Open Packaging Conventions (OPC) Specification</related>
   </Docs>
   <Members>

xml/System.IO.Packaging/Package.xml

@@ -21,16 +21,15 @@
   <Docs>
     <summary>Specifies the result of a certificate or signature verification.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Examples  
- The following example shows how to use the <xref:System.IO.Packaging.VerifyResult> enumeration.  
-  
- :::code language="csharp" source="~/snippets/csharp/System.IO.Packaging/CertificateEmbeddingOption/Overview/PackageDigitalSignature.cs" id="Snippetpackagedigsigvalidate":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Wpf/PackageDigitalSignature/visualbasic/packagedigitalsignature.vb" id="Snippetpackagedigsigvalidate":::  
-  
- For the complete sample, see [Creating a Package with a Digital Signature Sample](https://go.microsoft.com/fwlink/?LinkID=159966).  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Examples
+
+The following example shows how to use the <xref:System.IO.Packaging.VerifyResult> enumeration.
+
+:::code language="csharp" source="~/snippets/csharp/System.IO.Packaging/CertificateEmbeddingOption/Overview/PackageDigitalSignature.cs" id="Snippetpackagedigsigvalidate":::
+:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Wpf/PackageDigitalSignature/visualbasic/packagedigitalsignature.vb" id="Snippetpackagedigsigvalidate":::
+
  ]]></format>
     </remarks>
     <altmember cref="Overload:System.IO.Packaging.PackageDigitalSignature.Verify" />
@@ -39,7 +38,6 @@
     <altmember cref="T:System.IO.Packaging.PackageDigitalSignature" />
     <altmember cref="T:System.IO.Packaging.PackageDigitalSignatureManager" />
     <altmember cref="T:System.IO.Packaging.InvalidSignatureEventHandler" />
-    <related type="ExternalDocumentation" href="https://go.microsoft.com/fwlink/?LinkID=159966">Creating a Package with a Digital Signature Sample</related>
   </Docs>
   <Members>
     <Member MemberName="CertificateRequired">

xml/System.IO.Packaging/PackageDigitalSignatureManager.xml

@@ -49,30 +49,24 @@
   <Docs>
     <summary>Implements a derived subclass of the abstract <see cref="T:System.IO.Packaging.Package" /> base class - the <see cref="T:System.IO.Packaging.ZipPackage" /> class uses a ZIP archive as the container store. This class cannot be inherited.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The **Package**.<xref:System.IO.Packaging.Package.Open%2A> method uses <xref:System.IO.Packaging.ZipPackage> containers by default.  
-  
-   
-  
-## Examples  
- This example shows how to create a basic <xref:System.IO.Packaging.ZipPackage>.  
-  
- The example creates a package that contains a single document part which is defined as the package's root element by a package-level <xref:System.IO.Packaging.PackageRelationship>.  
-  
- The package also contains an image part and a second <xref:System.IO.Packaging.PackageRelationship> which defines an association between the source document part and the target image part.  (The image is a resource that is used with the document).  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The **Package**.<xref:System.IO.Packaging.Package.Open%2A> method uses <xref:System.IO.Packaging.ZipPackage> containers by default.
+
+## Examples
+ This example shows how to create a basic <xref:System.IO.Packaging.ZipPackage>.
+
+ The example creates a package that contains a single document part which is defined as the package's root element by a package-level <xref:System.IO.Packaging.PackageRelationship>.
+
+ The package also contains an image part and a second <xref:System.IO.Packaging.PackageRelationship> which defines an association between the source document part and the target image part.  (The image is a resource that is used with the document).
+
  :::code language="csharp" source="~/snippets/csharp/System.IO.Packaging/Package/Overview/PackageWrite.cs" id="Snippetpackagewritecreatepackage":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Wpf/PackageWrite/visualbasic/packagewrite.vb" id="Snippetpackagewritecreatepackage":::  
-  
- For the complete sample, see [Writing a Package Sample](https://go.microsoft.com/fwlink/?LinkID=160055).  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Wpf/PackageWrite/visualbasic/packagewrite.vb" id="Snippetpackagewritecreatepackage":::
+
  ]]></format>
     </remarks>
     <altmember cref="T:System.IO.Packaging.PackagePart" />
-    <related type="ExternalDocumentation" href="https://go.microsoft.com/fwlink/?LinkID=160055">Writing a Package Sample</related>
-    <related type="ExternalDocumentation" href="https://go.microsoft.com/fwlink/?LinkID=160034">Reading a Package Sample</related>
   </Docs>
   <Members>
     <Member MemberName="CreatePartCore">
@@ -309,13 +303,13 @@
         <returns>An array of <see cref="T:System.IO.Packaging.ZipPackagePart" /> objects.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
-          
-Some or all of the parts may be interleaved. The Part object for an interleaved part encapsulates the Uri of the proper part name and the ZipFileInfo of the initial piece. This function does not go through the extra work of checking piece naming validity throughout the package. 
-            
+
+Some or all of the parts may be interleaved. The Part object for an interleaved part encapsulates the Uri of the proper part name and the ZipFileInfo of the initial piece. This function does not go through the extra work of checking piece naming validity throughout the package.
+
 This means that interleaved parts without an initial piece will be silently ignored. Other naming anomalies are caught at the stream level when an I/O operation involves an anomalous or missing piece.
-            
+
 This function reads directly from the underlying IO layer and is supposed to be called just once in the lifetime of a package (at initialization time).
-            
+
           ]]></format>
         </remarks>
       </Docs>

xml/System.IO.Packaging/PackageRelationshipSelector.xml

@@ -39,15 +39,13 @@
   <Docs>
     <summary>Represents a part that is stored in a <see cref="T:System.IO.Packaging.ZipPackage" />.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- <xref:System.IO.Packaging.ZipPackagePart> provides the derived <xref:System.IO.Packaging.PackagePart> implementation for parts that are stored in a <xref:System.IO.Packaging.ZipPackage>.  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ <xref:System.IO.Packaging.ZipPackagePart> provides the derived <xref:System.IO.Packaging.PackagePart> implementation for parts that are stored in a <xref:System.IO.Packaging.ZipPackage>.
+
  ]]></format>
     </remarks>
-    <related type="ExternalDocumentation" href="https://go.microsoft.com/fwlink/?LinkID=160055">Writing a Package Sample</related>
-    <related type="ExternalDocumentation" href="https://go.microsoft.com/fwlink/?LinkID=160034">Reading a Package Sample</related>
   </Docs>
   <Members>
     <Member MemberName="GetStreamCore">