Fix broken links (dotnet#2236)

* update

* fixed cdata format

* Update IdentityReference.xml

* Update Label.xml

* feedback comments

* checking in changes

* fix build error

* fixing closing tag

* additional feedback

Author: Rodel

xml/System.IO.Log/SequenceNumber.xml

@@ -211,7 +211,7 @@
         <returns>
           <see langword="true" /> if both <see cref="T:System.IO.Log.SequenceNumber" /> instances are equal; otherwise, <see langword="false" />.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[The equivalent method for this operator is <xref:System.IO.Log.SequenceNumber.Equals%28System.IO.Log.SequenceNumber%2CSystem.IO.Log.SequenceNumber%29?displayProperty=fullName>]]></format>
+          <format type="text/markdown"><![CDATA[The equivalent method for this operator is <xref:System.IO.Log.SequenceNumber.CompareTo*?displayProperty=fullName>.]]></format>
         </remarks>
       </Docs>
     </Member>
@@ -238,7 +238,7 @@
         <returns>
           <see langword="true" /> if the first instance is greater than the second instance, otherwise, <see langword="false" />.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[The equivalent method for this operator is <xref:System.IO.Log.SequenceNumber.Compare%28System.IO.Log.SequenceNumber%2CSystem.IO.Log.SequenceNumber%29?displayProperty=fullName>]]></format>
+          <format type="text/markdown"><![CDATA[The equivalent method for this operator is <xref:System.IO.Log.SequenceNumber.CompareTo*>.]]></format>
         </remarks>
       </Docs>
     </Member>
@@ -265,7 +265,7 @@
         <returns>
           <see langword="true" /> if the first instance is greater than or equal to the second instance, otherwise, <see langword="false" />.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[The equivalent method for this operator is <xref:System.IO.Log.SequenceNumber.Compare%28System.IO.Log.SequenceNumber%2CSystem.IO.Log.SequenceNumber%29?displayProperty=fullName>]]></format>
+          <format type="text/markdown"><![CDATA[The equivalent method for this operator is <xref:System.IO.Log.SequenceNumber.CompareTo*>.]]></format>
         </remarks>
       </Docs>
     </Member>
@@ -292,7 +292,7 @@
         <returns>
           <see langword="true" /> if both <see cref="T:System.IO.Log.SequenceNumber" /> instances are not equal, otherwise, <see langword="false" />.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[The equivalent method for this operator is <xref:System.IO.Log.SequenceNumber.Compare%28System.IO.Log.SequenceNumber%2CSystem.IO.Log.SequenceNumber%29?displayProperty=fullName>]]></format>
+          <format type="text/markdown"><![CDATA[The equivalent method for this operator is <xref:System.IO.Log.SequenceNumber.CompareTo*>.]]></format>
         </remarks>
       </Docs>
     </Member>
@@ -319,7 +319,7 @@
         <returns>
           <see langword="true" /> if the first instance is less than the second instance, otherwise, <see langword="false" />.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[The equivalent method for this operator is <xref:System.IO.Log.SequenceNumber.Compare%28System.IO.Log.SequenceNumber%2CSystem.IO.Log.SequenceNumber%29?displayProperty=fullName>]]></format>
+          <format type="text/markdown"><![CDATA[The equivalent method for this operator is <xref:System.IO.Log.SequenceNumber.CompareTo*>.]]></format>
         </remarks>
       </Docs>
     </Member>
@@ -346,7 +346,7 @@
         <returns>
           <see langword="true" /> if the first instance is less than or equal to the second instance, otherwise, <see langword="false" />.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[The equivalent method for this operator is <xref:System.IO.Log.SequenceNumber.Compare%28System.IO.Log.SequenceNumber%2CSystem.IO.Log.SequenceNumber%29?displayProperty=fullName>]]></format>
+          <format type="text/markdown"><![CDATA[The equivalent method for this operator is <xref:System.IO.Log.SequenceNumber.CompareTo*>.]]></format>
         </remarks>
       </Docs>
     </Member>

xml/System.IO/Stream.xml

@@ -428,7 +428,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- If a class derived from <xref:System.IO.Stream> does not support writing, a call to <xref:System.IO.Stream.Write%2A>, <xref:System.IO.Stream.BeginWrite%2A>, or <xref:System.IO.Stream.WriteByte%2A> throws a <xref:System.NotSupportedException>. In such cases, <xref:System.IO.Stream.Flush%2A> is typically implemented as an empty method to ensure full compatibility with other <xref:System.IO.Stream> types since it's valid to flush a read-only stream.   
+ If a class derived from <xref:System.IO.Stream> does not support writing, a call to <xref:System.IO.Stream.Write%2A>, <xref:System.IO.Stream.BeginWrite%2A>, or <xref:System.IO.Stream.WriteByte%2A> throws a <xref:System.NotSupportedException>.  
   
  If the stream is closed, this property returns `false`.  
   
@@ -1076,8 +1076,6 @@
 ## Remarks  
  Override `Flush` on streams that implement a buffer. Use this method to move any information from an underlying buffer to its destination, clear the buffer, or both. Depending upon the state of the object, you might have to modify the current position within the stream (for example, if the underlying stream supports seeking). For additional information see <xref:System.IO.Stream.CanSeek%2A>.  
   
- In a class derived from <xref:System.IO.Stream> that doesn't support writing, <xref:System.IO.Stream.Flush%2A> is typically implemented as an empty method to ensure full compatibility with other <xref:System.IO.Stream> types since it's valid to flush a read-only stream.  
-  
  When using the <xref:System.IO.StreamWriter> or <xref:System.IO.BinaryWriter> class, do not flush the base <xref:System.IO.Stream> object. Instead, use the class's <xref:System.IO.Stream.Flush%2A> or <xref:System.IO.Stream.Close%2A> method, which makes sure that the data is flushed to the underlying stream first and then written to the file.  
   
  ]]></format>

xml/System.IdentityModel.Metadata/MetadataSerializationException.xml

@@ -31,7 +31,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- This constructor initializes the <xref:SystemException.Message> property of the new instance to a system-supplied message that describes the error. This message takes into account the current system culture.  
+ This constructor initializes the <xref:System.Exception.Message*> property of the new instance to a system-supplied message that describes the error. This message takes into account the current system culture.  
   
  The following table shows the initial property values for the new instance.  
   

xml/System.IdentityModel.Selectors/X509CertificateValidator.xml

@@ -290,7 +290,7 @@
 ## Remarks  
  Override the <xref:System.IdentityModel.Selectors.X509CertificateValidator.Validate%2A> method to specify how the X.509 certificate is validated.  
   
- When the X.509 certificate that is passed into the `certificate` parameter does not pass validation, throw the <xref:System.IdentityModel.Tokens.SecurityTokenvalidationException>.  
+ When the X.509 certificate that is passed into the `certificate` parameter does not pass validation, throw the <xref:System.IdentityModel.Tokens.SecurityTokenValidationException>.  
   
    
   

xml/System.IdentityModel.Services/AsynchronousOperationException.xml

@@ -31,7 +31,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- This constructor initializes the <xref:SystemException.Message> property of the new instance to a system-supplied message that describes the error. This message takes into account the current system culture.  
+ This constructor initializes the <xref:System.Exception.Message*> property of the new instance to a system-supplied message that describes the error. This message takes into account the current system culture.  
   
  The following table shows the initial property values for the new instance.  
   

xml/System.IdentityModel.Services/CookieHandlerElement.xml

@@ -16,7 +16,7 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The `<cookieHandler>` element is a child element of the `<federatedAuthentication>` element; the <xref:System.IdentityModel.Services.FederatedAuthenticationElement.CookieHandler%2A?displayProperty=fullName> property is set to an instance of the <xref:System.IdentityModel.Services.CookieHandlerElement> class. The `<cookieHandler>` element is used to configure the cookie handler used by the Session Authentication Module (SAM), which is represented by the <xref:System.IdentityModel.Services.SessionAuthenticationModule> class.  
+ The `<cookieHandler>` element is a child element of the `<federatedAuthentication>` element; the <xref:System.IdentityModel.Services.Configuration.FederationConfiguration.CookieHandler%2A?displayProperty=fullName> property is set to an instance of the <xref:System.IdentityModel.Services.CookieHandlerElement> class. The `<cookieHandler>` element is used to configure the cookie handler used by the Session Authentication Module (SAM), which is represented by the <xref:System.IdentityModel.Services.SessionAuthenticationModule> class.  
   
  A cookie handler can be configured in one of the following ways:  
   

xml/System.IdentityModel.Services/PseudonymRequestMessage.xml

@@ -215,7 +215,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- This method calls the <xref:System.IdentityModel.Services.PseudonymReqeustMessage.Validate%2A> method before writing the message.  
+ This method calls the <xref:System.IdentityModel.Services.PseudonymRequestMessage.Validate*> method before writing the message.  
   
  ]]></format>
         </remarks>

xml/System.IdentityModel.Services/WSFederationAuthenticationModule.xml

@@ -1852,7 +1852,7 @@
 ## Remarks  
  This event is raised through a call to the <xref:System.IdentityModel.Services.WSFederationAuthenticationModule.OnSigningOut%2A> method from inside the <xref:System.IdentityModel.Services.WSFederationAuthenticationModule.SignOut%28System.Boolean%29?displayProperty=fullName> method while signing out of the session at the relying party (RP). The event is not raised when doing federated sign-out through the <xref:System.IdentityModel.Services.WSFederationAuthenticationModule.FederatedSignOut%2A> method.  
   
- You can add an event handler to perform any additional processing that is needed by your application before the session cookie is deleted. You can read the <xref:System.IdentityModel.Services.SigningOutEventArgs.IsIPInitiated%2A> property in the event handler to determine whether the sign-out is the result of receiving a WS-Federation sign-out clean-up request message ("wsignoutcleanup1.0") from a security token service (STS) or whether it was initiated at the RP.  
+ You can add an event handler to perform any additional processing that is needed by your application before the session cookie is deleted. You can read the <xref:System.IdentityModel.Services.SigningOutEventArgs.IsIPInitiated*> property in the event handler to determine whether the sign-out is the result of receiving a WS-Federation sign-out clean-up request message ("wsignoutcleanup1.0") from a security token service (STS) or whether it was initiated at the RP.  
   
  This event is not guaranteed to be called for every session. Cookies may be deleted at the client side, for example, so this event would never be raised.  
   
@@ -1961,7 +1961,7 @@
 ## Remarks  
  This method performs the actual work of deleting the current session and raising the appropriate sign-out events. The method does the following:  
   
-1.  Invokes the <xref:System.IdentityModel.Services.WSFederationAuthenticationModule.OnSigningOut%2A> method to raise the <xref:System.IdentityModel.Services.WSFederationAuthenticationModule.SigningOut> event. An event handler can provide any necessary processing before the session is deleted. The <xref:System.IdentityModel.Services.SigningOutEventArgs.IsIpInitiated%2A?displayProperty=fullName> property is set according to the `isIPRequest` parameter.  
+1.  Invokes the <xref:System.IdentityModel.Services.WSFederationAuthenticationModule.OnSigningOut%2A> method to raise the <xref:System.IdentityModel.Services.WSFederationAuthenticationModule.SigningOut> event. An event handler can provide any necessary processing before the session is deleted. The <xref:System.IdentityModel.Services.SigningOutEventArgs.IsIPInitiated%2A?displayProperty=fullName> property is set according to the `isIPRequest` parameter.  
   
 2.  Calls the <xref:System.IdentityModel.Services.SessionAuthenticationModule.DeleteSessionTokenCookie%2A?displayProperty=fullName> method on the current session authentication manager to delete the session cookie.  
   

xml/System.IdentityModel.Tokens/Saml2AuthenticationContext.xml

@@ -143,7 +143,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The ClassReference element. This can be one of URI constants defined in the <xref:System.IdentityModel.Tokens.Saml2Constants.AuthenticationContextClasses> class.  
+ The ClassReference element. This can be one of URI constants defined in the [AuthenticationContextClasses](https://referencesource.microsoft.com/#System.IdentityModel/System/IdentityModel/Tokens/Saml2Constants.cs,77) class.  
   
  ]]></format>
         </remarks>
@@ -177,4 +177,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.IdentityModel.Tokens/Saml2SecurityToken.xml

@@ -97,7 +97,7 @@
 ## Remarks  
  For <xref:System.IdentityModel.Tokens.Saml2SecurityToken> security tokens, the claims are specified using a SAML assertion.  
   
- Use a constructor or the <xref:System.IdentityModel.Tokens.Saml2SecurityToken.Initialize%28System.IdentityModel.Tokens.Saml2Assertion%29> method to set the <xref:System.IdentityModel.Tokens.Saml2SecurityToken.Assertion%2A> property.  
+ Use a constructor or the <xref:System.IdentityModel.Tokens.Saml2SecurityToken.%23ctor%28System.IdentityModel.Tokens.Saml2Assertion%29?displayProperty=fullName> method to set the <xref:System.IdentityModel.Tokens.Saml2SecurityToken.Assertion%2A> property.  
   
  ]]></format>
         </remarks>