diff --git a/xml/System.Net/Authorization.xml b/xml/System.Net/Authorization.xml
index 59dd6f486fe..6c87e2500b7 100644
--- a/xml/System.Net/Authorization.xml
+++ b/xml/System.Net/Authorization.xml
@@ -49,16 +49,7 @@
Contains an authentication message for an Internet server.
-
- returns an instance of the class that contains an authentication message. This message is sent to the Internet server to indicate that the client (such as or one of its descendants) is authorized to access the server.
-
- The instance is created by the authentication module that the designates to handle the request.
-
- ]]>
-
+ To be added.
@@ -115,13 +106,11 @@
instance is created with the property set to `token` and the property set to `true`.
-
-
+ The instance is created with the property set to `token` and the property set to `true`.
## Examples
- The following code example shows how to create an object. For a complete example, refer to the class.
-
+ The following code example shows how to create an object.
+
:::code language="csharp" source="~/snippets/csharp/System.Net/AuthenticationManager/Overview/custombasicauthentication.cs" id="Snippet3":::
:::code language="vb" source="~/snippets/visualbasic/System.Net/AuthenticationManager/Overview/custombasicauthentication.vb" id="Snippet3":::
@@ -174,9 +163,7 @@
instance is created with the property set to `token` and the property set to `finished`.
-
-
+ The instance is created with the property set to `token` and the property set to `finished`.
## Examples
The following code example creates a new instance of the class with the specified authorization message and completion status.
@@ -299,12 +286,10 @@
property is set to `true` when the authentication process between the client and the server is finished. Some authentication modules, such as the Kerberos module, use multiple round trips between the client and server to complete the authentication process. To keep the or descendant that initiated the authentication process from interrupting while authorization is taking place, the authentication module sets the property to `false`.
-
-
+ The property is set to `true` when the authentication process between the client and the server is finished. Some authentication modules, such as the Kerberos module, use multiple round trips between the client and server to complete the authentication process. To keep the or descendant that initiated the authentication process from interrupting while authorization is taking place, the authentication module sets the property to `false`.
## Examples
- The following code example uses the property to get the completion status of the authorization. For a complete example, refer to the class.
+ The following code example uses the property to get the completion status of the authorization.
:::code language="csharp" source="~/snippets/csharp/System.Net/AuthenticationManager/Overview/custombasicauthentication.cs" id="Snippet5":::
:::code language="vb" source="~/snippets/visualbasic/System.Net/AuthenticationManager/Overview/custombasicauthentication.vb" id="Snippet5":::
@@ -363,12 +348,10 @@
property is a unique string that associates a connection with a specific authenticating entity. For example, the NTLM authorization module ties the authentication credential information to a specific connection to prevent invalid reuse of the connection.
-
-
+ The property is a unique string that associates a connection with a specific authenticating entity. For example, the NTLM authorization module ties the authentication credential information to a specific connection to prevent invalid reuse of the connection.
## Examples
- The following code example uses the property to get the group identifier returned by the server. For a complete example, refer to the class.
+ The following code example uses the property to get the group identifier returned by the server.
:::code language="csharp" source="~/snippets/csharp/System.Net/AuthenticationManager/Overview/custombasicauthentication.cs" id="Snippet5":::
:::code language="vb" source="~/snippets/visualbasic/System.Net/AuthenticationManager/Overview/custombasicauthentication.vb" id="Snippet5":::
@@ -426,14 +409,12 @@
property contains the authorization string that the client will return to the server when accessing protected resources. The actual contents of the message are defined by the authentication type the client and server are using. Basic HTTP authentication, for example, uses a different message than Kerberos authentication.
-
- When an authentication module supports preauthentication, the property is sent with the initial request.
-
+ The property contains the authorization string that the client will return to the server when accessing protected resources. The actual contents of the message are defined by the authentication type the client and server are using. Basic HTTP authentication, for example, uses a different message than Kerberos authentication.
+ When an authentication module supports preauthentication, the property is sent with the initial request.
## Examples
- The following code example uses the property to get the message returned to the server in response to an authentication challenge. For a complete example, refer to the class.
+ The following code example uses the property to get the message returned to the server in response to an authentication challenge.
:::code language="csharp" source="~/snippets/csharp/System.Net/AuthenticationManager/Overview/custombasicauthentication.cs" id="Snippet5":::
:::code language="vb" source="~/snippets/visualbasic/System.Net/AuthenticationManager/Overview/custombasicauthentication.vb" id="Snippet5":::
@@ -484,17 +465,10 @@
System.Boolean
- Gets or sets a value that indicates whether mutual authentication occurred.
+ Gets or sets a value that indicates whether mutual authentication occurred.
- if both client and server were authenticated; otherwise, .
-
-
-
+ if both client and server were authenticated; if client or server weren't authenticated or if authentication hasn't completed.
+ To be added.
@@ -550,12 +524,10 @@
property contains a list of URI prefixes that the property can be used to authenticate. and its descendants compare a URI to this list to determine if the is valid for a particular URI.
-
-
+ The property contains a list of URI prefixes that the property can be used to authenticate. and its descendants compare a URI to this list to determine if the is valid for a particular URI.
## Examples
- The following code example gets or sets the prefix for URIs that can be authenticated with the property.
+ The following code example gets or sets the prefix for URIs that can be authenticated with the property.
:::code language="csharp" source="~/snippets/csharp/System.Net/Authorization/.ctor/authorization_protectionrealm.cs" id="Snippet1":::
:::code language="vb" source="~/snippets/visualbasic/System.Net/Authorization/.ctor/authorization_protectionrealm.vb" id="Snippet1":::