Fix broken links (#4223)

gewarren · web-flow · commit a5a9f597a963 · 2020-05-13T16:22:40.000-07:00
* fix broken links
diff --git a/xml/System.Data.SqlClient/SqlColumnEncryptionCertificateStoreProvider.xml b/xml/System.Data.SqlClient/SqlColumnEncryptionCertificateStoreProvider.xml
@@ -20,8 +20,8 @@
   <Docs>
     <summary>The implementation of the key store provider for Windows Certificate Store. This class enables using certificates stored in the Windows Certificate Store as column master keys. For details, see <see href="https://docs.microsoft.com/sql/relational-databases/security/encryption/always-encrypted-database-engine">Always Encrypted</see>.</summary>
     <remarks>To be added.</remarks>
-    <related type="ExternalDocumentation" href="https://blogs.msdn.microsoft.com/sqlsecurity/tag/always-encrypted/">Always Encrypted (blog posts)</related>
-    <related type="ExternalDocumentation" href="https://msdn.microsoft.com/library/mt147923.aspx">Always Encrypted (client development)</related>
+    <related type="ExternalDocumentation" href="https://techcommunity.microsoft.com/t5/sql-server/getting-started-with-always-encrypted/ba-p/384397">Get started with Always Encrypted (blog post)</related>
+    <related type="ExternalDocumentation" href="/sql/relational-databases/security/encryption/always-encrypted-client-development">Develop apps using Always Encrypted</related>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
diff --git a/xml/System.Data.SqlClient/SqlColumnEncryptionCngProvider.xml b/xml/System.Data.SqlClient/SqlColumnEncryptionCngProvider.xml
@@ -23,8 +23,8 @@
   
  ]]></format>
     </remarks>
-    <related type="ExternalDocumentation" href="https://blogs.msdn.microsoft.com/sqlsecurity/tag/always-encrypted/">Always Encrypted (blog posts)</related>
-    <related type="ExternalDocumentation" href="https://msdn.microsoft.com/library/mt147923.aspx">Always Encrypted (client development)</related>
+    <related type="ExternalDocumentation" href="https://techcommunity.microsoft.com/t5/sql-server/getting-started-with-always-encrypted/ba-p/384397">Get started with Always Encrypted (blog post)</related>
+    <related type="ExternalDocumentation" href="/sql/relational-databases/security/encryption/always-encrypted-client-development">Develop apps using Always Encrypted</related>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
diff --git a/xml/System.Data.SqlClient/SqlColumnEncryptionCspProvider.xml b/xml/System.Data.SqlClient/SqlColumnEncryptionCspProvider.xml
@@ -23,8 +23,8 @@
   
  ]]></format>
     </remarks>
-    <related type="ExternalDocumentation" href="https://blogs.msdn.microsoft.com/sqlsecurity/tag/always-encrypted/">Always Encrypted (blog posts)</related>
-    <related type="ExternalDocumentation" href="/sql/relational-databases/security/encryption/always-encrypted-client-development">Always Encrypted (client development)</related>
+    <related type="ExternalDocumentation" href="https://techcommunity.microsoft.com/t5/sql-server/getting-started-with-always-encrypted/ba-p/384397">Get started with Always Encrypted (blog post)</related>
+    <related type="ExternalDocumentation" href="/sql/relational-databases/security/encryption/always-encrypted-client-development">Develop apps using Always Encrypted</related>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
diff --git a/xml/System.Data.SqlClient/SqlColumnEncryptionKeyStoreProvider.xml b/xml/System.Data.SqlClient/SqlColumnEncryptionKeyStoreProvider.xml
@@ -16,8 +16,8 @@
   <Docs>
     <summary>Base class for all key store providers. A custom provider must derive from this class and override its member functions and then register it using SqlConnection.RegisterColumnEncryptionKeyStoreProviders(). For details see, <see href="https://docs.microsoft.com/sql/relational-databases/security/encryption/always-encrypted-database-engine">Always Encrypted</see>.</summary>
     <remarks>To be added.</remarks>
-    <related type="ExternalDocumentation" href="https://blogs.msdn.microsoft.com/sqlsecurity/tag/always-encrypted/">Always Encrypted (blog posts)</related>
-    <related type="ExternalDocumentation" href="/sql/relational-databases/security/encryption/always-encrypted-client-development">Always Encrypted (client development)</related>
+    <related type="ExternalDocumentation" href="https://techcommunity.microsoft.com/t5/sql-server/getting-started-with-always-encrypted/ba-p/384397">Get started with Always Encrypted (blog post)</related>
+    <related type="ExternalDocumentation" href="/sql/relational-databases/security/encryption/always-encrypted-client-development">Develop apps using Always Encrypted</related>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
diff --git a/xml/System.Net/HttpListenerRequest.xml b/xml/System.Net/HttpListenerRequest.xml
@@ -1203,9 +1203,7 @@
  In a URL, the query information is separated from the path information by a question mark (?). Name/value pairs are separated by an equals sign (=). To access the query data as a single string, get the <xref:System.Uri.Query%2A> property value from the <xref:System.Uri> object returned by <xref:System.Net.HttpListenerRequest.Url%2A>.  
   
 > [!NOTE]
->  Queries without an equal sign (example: [http://www.contoso.com/query.htm?Name](http://www.contoso.com/query.htm?Name) ) are added to the `null` key in the <xref:System.Collections.Specialized.NameValueCollection>.  
-  
-   
+> Queries without an equals sign (for example, `http://www.contoso.com/query.htm?Name`) are added to the `null` key in the <xref:System.Collections.Specialized.NameValueCollection>.
   
 ## Examples  
  The following code example demonstrates using the <xref:System.Net.HttpListenerRequest.QueryString%2A> property.  
diff --git a/xml/System.Reflection.Metadata.Ecma335/MetadataBuilder.xml b/xml/System.Reflection.Metadata.Ecma335/MetadataBuilder.xml
@@ -372,11 +372,11 @@ Entries may be added in any order. The table is automatically sorted when serial
 
 ## Remarks
 
-For more information about `name`, see <https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PortablePdb-Metadata.md#document-name-blob>.
+For more information about `name`, see <https://github.com/dotnet/runtime/blob/master/docs/design/specs/PortablePdb-Metadata.md#document-name-blob>.
 
-For more information about common values for `hashAlgorithm`, see <https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PortablePdb-Metadata.md#document-table-0x30>.
+For more information about common values for `hashAlgorithm`, see <https://github.com/dotnet/runtime/blob/master/docs/design/specs/PortablePdb-Metadata.md#document-table-0x30>.
 
-For more information about common values for `language`, see <https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PortablePdb-Metadata.md#document-table-0x30>.
+For more information about common values for `language`, see <https://github.com/dotnet/runtime/blob/master/docs/design/specs/PortablePdb-Metadata.md#document-table-0x30>.
 
           ]]></format>
         </remarks>
@@ -778,7 +778,7 @@ Constraints must be added in the same order as the corresponding generic paramet
 
 ## Remarks
 
-For more information about `imports`, see <https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PortablePdb-Metadata.md#imports-blob>.
+For more information about `imports`, see <https://github.com/dotnet/runtime/blob/master/docs/design/specs/PortablePdb-Metadata.md#imports-blob>.
 
           ]]></format>
         </remarks>
@@ -860,7 +860,7 @@ If a type implements multiple interfaces, the corresponding entries must be adde
 
 ## Remarks
 
-For more information about `signature`, see: [LocalConstantSig Blob](https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PortablePdb-Metadata.md#localconstantsig-blob) on GitHub.
+For more information about `signature`, see: [LocalConstantSig Blob](https://github.com/dotnet/runtime/blob/master/docs/design/specs/PortablePdb-Metadata.md#localconstantsig-blob) on GitHub.
 
           ]]></format>
         </remarks>
@@ -1093,7 +1093,7 @@ Entries may be added in any order. The table is automatically sorted when serial
 
 ## Remarks
 
-For more information about `sequencePoints`, see: [Sequence Points Blob](https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PortablePdb-Metadata.md#sequence-points-blob) on GitHub.
+For more information about `sequencePoints`, see: [Sequence Points Blob](https://github.com/dotnet/runtime/blob/master/docs/design/specs/PortablePdb-Metadata.md#sequence-points-blob) on GitHub.
 
           ]]></format>
         </remarks>
@@ -1931,7 +1931,7 @@ Entires must be added in the same order as the corresponding type definitions.
 
 ## Remarks
 
-For more information about document name blobs, see: https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PortablePdb-Metadata.md#DocumentNameBlob
+For more information about document name blobs, see: https://github.com/dotnet/runtime/blob/master/docs/design/specs/PortablePdb-Metadata.md#DocumentNameBlob
 
           ]]></format>
         </remarks>
diff --git a/xml/System.Reflection.Metadata/Document.xml b/xml/System.Reflection.Metadata/Document.xml
@@ -31,7 +31,7 @@
 
 ## Remarks
 
-For more information, see [Portable PDB v1.0: Format Specification](https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PortablePdb-Metadata.md#document-table-0x30).
+For more information, see [Portable PDB v1.0: Format Specification](https://github.com/dotnet/runtime/blob/master/docs/design/specs/PortablePdb-Metadata.md#document-table-0x30).
 
       ]]></format>
     </remarks>
diff --git a/xml/System.Reflection.Metadata/ImportScope.xml b/xml/System.Reflection.Metadata/ImportScope.xml
@@ -31,7 +31,7 @@
 
 ## Remarks
 
-See [ImportScope Table" 0x35](https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PortablePdb-Metadata.md#importscope-table-0x35) for more information.
+See [ImportScope Table" 0x35](https://github.com/dotnet/runtime/blob/master/docs/design/specs/PortablePdb-Metadata.md#importscope-table-0x35) for more information.
 
       ]]></format>
     </remarks>
diff --git a/xml/System.Reflection.Metadata/LocalConstant.xml b/xml/System.Reflection.Metadata/LocalConstant.xml
@@ -31,7 +31,7 @@
 
 ## Remarks
 
-See [LocalConstant Table: 0x34](https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PortablePdb-Metadata.md#localconstant-table-0x34).
+See [LocalConstant Table: 0x34](https://github.com/dotnet/runtime/blob/master/docs/design/specs/PortablePdb-Metadata.md#localconstant-table-0x34).
 
       ]]></format>
     </remarks>
diff --git a/xml/System.Reflection.Metadata/LocalScope.xml b/xml/System.Reflection.Metadata/LocalScope.xml
@@ -31,7 +31,7 @@
 
 ## Remarks
 
-See [LocalScope Table: 0x32](https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PortablePdb-Metadata.md#localscope-table-0x32).
+See [LocalScope Table: 0x32](https://github.com/dotnet/runtime/blob/master/docs/design/specs/PortablePdb-Metadata.md#localscope-table-0x32).
 
       ]]></format>
     </remarks>
diff --git a/xml/System.Reflection.Metadata/LocalVariable.xml b/xml/System.Reflection.Metadata/LocalVariable.xml
@@ -31,7 +31,7 @@
 
 ## Remarks
 
-See [LocalVariable Table: 0x33](https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PortablePdb-Metadata.md#localvariable-table-0x33) for more information.
+See [LocalVariable Table: 0x33](https://github.com/dotnet/runtime/blob/master/docs/design/specs/PortablePdb-Metadata.md#localvariable-table-0x33) for more information.
 
       ]]></format>
     </remarks>
diff --git a/xml/System.Reflection.Metadata/MethodDebugInformation.xml b/xml/System.Reflection.Metadata/MethodDebugInformation.xml
@@ -31,7 +31,7 @@
 
 ## Remarks
 
-See [MethodDebugInformation Table: 0x31](https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PortablePdb-Metadata.md#methoddebuginformation-table-0x31).
+See [MethodDebugInformation Table: 0x31](https://github.com/dotnet/runtime/blob/master/docs/design/specs/PortablePdb-Metadata.md#methoddebuginformation-table-0x31).
 
       ]]></format>
     </remarks>
diff --git a/xml/System.Reflection.PortableExecutable/DebugDirectoryEntryType.xml b/xml/System.Reflection.PortableExecutable/DebugDirectoryEntryType.xml
@@ -29,10 +29,10 @@ See the following for the specifications related to individual enumeration membe
 
 |Member|Specification|
 |---|---|
-|`CodeView`|[CodeView Debug Directory Entry (type 2)](https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PE-COFF.md#codeview-debug-directory-entry-type-2)|
-|`EmbeddedPortablePdb`|[Embedded Portale PDB Debu Directory Entry (type 17)](https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PE-COFF.md#embedded-portable-pdb-debug-directory-entry-type-17)|
-|`PdbChecksum`|[PDB Checksum Debug Directory Entry (type 19)](https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PE-COFF.md#pdb-checksum-debug-directory-entry-type-19)|
-|`Reproducible`|See [Deterministic Debug Directory Entry (type 16)](https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PE-COFF.md#deterministic-debug-directory-entry-type-16)|
+|`CodeView`|[CodeView Debug Directory Entry (type 2)](https://github.com/dotnet/runtime/blob/master/docs/design/specs/PE-COFF.md#codeview-debug-directory-entry-type-2)|
+|`EmbeddedPortablePdb`|[Embedded Portale PDB Debu Directory Entry (type 17)](https://github.com/dotnet/runtime/blob/master/docs/design/specs/PE-COFF.md#embedded-portable-pdb-debug-directory-entry-type-17)|
+|`PdbChecksum`|[PDB Checksum Debug Directory Entry (type 19)](https://github.com/dotnet/runtime/blob/master/docs/design/specs/PE-COFF.md#pdb-checksum-debug-directory-entry-type-19)|
+|`Reproducible`|See [Deterministic Debug Directory Entry (type 16)](https://github.com/dotnet/runtime/blob/master/docs/design/specs/PE-COFF.md#deterministic-debug-directory-entry-type-16)|
 
 ### DebugDirectoryEntryType.Reproducible 
 
@@ -75,7 +75,7 @@ The debug directory entry of type <xref:System.Reflection.PortableExecutable.Deb
 
 ## Remarks
 
-See https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PE-COFF.md#codeview-debug-directory-entry-type-2 for specification.
+See https://github.com/dotnet/runtime/blob/master/docs/design/specs/PE-COFF.md#codeview-debug-directory-entry-type-2 for specification.
 
           ]]></format>
         </remarks>
@@ -145,7 +145,7 @@ The Embedded Portable PDB blob has the following format:
  blob ::= uncompressed-size data 
  Data spans the remainder of the blob and contains a Deflate-compressed Portable PDB.
  
- See https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PE-COFF.md#embedded-portable-pdb-debug-directory-entry-type-17 for specification.
+ See https://github.com/dotnet/runtime/blob/master/docs/design/specs/PE-COFF.md#embedded-portable-pdb-debug-directory-entry-type-17 for specification.
 
           ]]></format>
         </remarks>
@@ -180,7 +180,7 @@ The Embedded Portable PDB blob has the following format:
 The hash can be used to validate that a given PDB file was built with the PE/COFF file and not altered in any way.
  More than one entry can be present, in case multiple PDBs were produced during the build of the PE/COFF file (e.g. private and public symbols).
  
- See https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PE-COFF.md#pdb-checksum-debug-directory-entry-type-19 for specification.
+ See https://github.com/dotnet/runtime/blob/master/docs/design/specs/PE-COFF.md#pdb-checksum-debug-directory-entry-type-19 for specification.
 
           ]]></format>
         </remarks>
@@ -219,7 +219,7 @@ The hash can be used to validate that a given PDB file was built with the PE/COF
   The value of field TimeDateStamp in COFF File Header of a deterministic PE/COFF file does not indicate the date and time when the file was produced and should not be interpreted that way.
  Instead the value of the field is derived from a hash of the file content. The algorithm to calculate this value is an implementation detail of the tool that produced the file.
   The debug directory entry of type <xref:System.Reflection.PortableExecutable.DebugDirectoryEntryType.Reproducible> must have all fields, except for Type zeroed.
-  See https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PE-COFF.md#deterministic-debug-directory-entry-type-16 for specification.
+  See https://github.com/dotnet/runtime/blob/master/docs/design/specs/PE-COFF.md#deterministic-debug-directory-entry-type-16 for specification.
  
 
           ]]></format>
diff --git a/xml/System.Reflection.PortableExecutable/PdbChecksumDebugDirectoryData.xml b/xml/System.Reflection.PortableExecutable/PdbChecksumDebugDirectoryData.xml
@@ -28,7 +28,7 @@
 
 ## Remarks
 
-For more information, see: https://github.com/dotnet/runtime/blob/master/src/libraries/System.Reflection.Metadata/specs/PE-COFF.md#pdb-checksum-debug-directory-entry-type-19
+For more information, see: https://github.com/dotnet/runtime/blob/master/docs/design/specs/PE-COFF.md#pdb-checksum-debug-directory-entry-type-19
 
       ]]></format>
     </remarks>
diff --git a/xml/System.Runtime.CompilerServices/INotifyCompletion.xml b/xml/System.Runtime.CompilerServices/INotifyCompletion.xml
@@ -40,7 +40,7 @@
     <summary>Represents an operation that schedules continuations when it completes.</summary>
     <remarks>To be added.</remarks>
     <altmember cref="T:System.Runtime.CompilerServices.TaskAwaiter" />
-    <related type="ExternalDocumentation" href="https://go.microsoft.com/fwlink/?LinkId=254303">What's New for Parallelism in .NET 4.5</related>
+    <related type="ExternalDocumentation" href="https://devblogs.microsoft.com/pfxteam/whats-new-for-parallelism-in-visual-studio-2012-rc/">What's New for Parallelism in .NET 4.5</related>
   </Docs>
   <Members>
     <Member MemberName="OnCompleted">
diff --git a/xml/System.Windows.Controls.Primitives/CustomPopupPlacementCallback.xml b/xml/System.Windows.Controls.Primitives/CustomPopupPlacementCallback.xml
@@ -41,6 +41,6 @@
     <altmember cref="P:System.Windows.Controls.Primitives.Popup.CustomPopupPlacementCallback" />
     <altmember cref="P:System.Windows.Controls.ToolTip.CustomPopupPlacementCallback" />
     <altmember cref="P:System.Windows.Controls.ContextMenu.CustomPopupPlacementCallback" />
-    <related type="ExternalDocumentation" href="https://go.microsoft.com/fwlink/?LinkID=160032">Popup Placement Sample</related>
+    <related type="ExternalDocumentation" href="https://github.com/dotnet/dotnet-api-docs/tree/master/samples/snippets/csharp/VS_Snippets_Wpf/PopupPositionSnippet/CS">Popup Placement Sample</related>
   </Docs>
 </Type>
diff --git a/xml/System.Windows.Controls.Primitives/Popup.xml b/xml/System.Windows.Controls.Primitives/Popup.xml
@@ -1138,9 +1138,7 @@
 |||  
 |-|-|  
 |Identifier field|<xref:System.Windows.Controls.Primitives.Popup.PlacementRectangleProperty>|  
-|Metadata properties set to `true`|None|  
-  
-   
+|Metadata properties set to `true`|None|
   
 ## Examples  
  The following example sets the <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A> property of a <xref:System.Windows.Controls.Primitives.Popup>. The <xref:System.Windows.Rect.X%2A>, <xref:System.Windows.Rect.Y%2A>, <xref:System.Windows.Rect.Width%2A>, and <xref:System.Windows.Rect.Height%2A> properties of the <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A> are 50, 50, 50, and 100, respectively. The <xref:System.Windows.Controls.Primitives.Popup> is relative to the bounds of the <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A> property. Note that the <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A> property does not create a visible element in the application; the example creates a <xref:System.Windows.Shapes.Rectangle> with the same bounds to represent the <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>.  
@@ -1153,7 +1151,7 @@
         <altmember cref="P:System.Windows.Controls.Primitives.Popup.Placement" />
         <altmember cref="P:System.Windows.Controls.Primitives.Popup.VerticalOffset" />
         <altmember cref="P:System.Windows.Controls.Primitives.Popup.HorizontalOffset" />
-        <related type="ExternalDocumentation" href="https://go.microsoft.com/fwlink/?LinkID=160032">Popup Placement Sample</related>
+        <related type="ExternalDocumentation" href="https://github.com/dotnet/dotnet-api-docs/tree/master/samples/snippets/csharp/VS_Snippets_Wpf/PopupPositionSnippet/CS">Popup Placement Sample</related>
       </Docs>
     </Member>
     <Member MemberName="PlacementRectangleProperty">
diff --git a/xml/System.Windows.Controls/ContextMenu.xml b/xml/System.Windows.Controls/ContextMenu.xml
@@ -195,8 +195,8 @@
   
  The <xref:System.Windows.Controls.Primitives.CustomPopupPlacementCallback> delegate returns an array of possible points that are defined with respect to the <xref:System.Windows.Controls.ContextMenu.PlacementTarget%2A>. When the context menu is displayed, a point is chosen that maximizes the amount of the <xref:System.Windows.Controls.ToolTip> window that is visible.  
   
- The behavior is the same as it is for the popup.  For more information, see [How to: Specify a Custom Popup Position](~/docs/framework/wpf/controls/how-to-specify-a-custom-popup-position.md) and [Popup Placement Sample](https://go.microsoft.com/fwlink/?LinkID=160032).  
-  
+ The behavior is the same as it is for the popup. For more information, see [How to: Specify a Custom Popup Position](~/docs/framework/wpf/controls/how-to-specify-a-custom-popup-position.md) and [Popup Placement Sample](https://github.com/dotnet/dotnet-api-docs/tree/master/samples/snippets/csharp/VS_Snippets_Wpf/PopupPositionSnippet/CS).
+ 
 <a name="dependencyPropertyInfo_CustomPopupPlacementCallback"></a>   
 ## Dependency Property Information  
   
diff --git a/xml/System.Windows.Controls/ToolTip.xml b/xml/System.Windows.Controls/ToolTip.xml
diff --git a/xml/System.Windows.Forms/PictureBox.xml b/xml/System.Windows.Forms/PictureBox.xml
