edit asp0028 /1

Author: Rick-Anderson

aspnetcore/diagnostics/asp0028.md

@@ -17,7 +17,7 @@ uid: diagnostics/asp0028
 
 ## Cause
 
-`IPv6Any` is preferred to `Any` because `Any` is less performant than `IPv6Any`. In some cases, `Any` may not work at all. `Any` has performance problems due to the [underlying System types implementation](https://github.com/dotnet/runtime/issues/82404).
+[IPv6Any](/dotnet/api/system.net.ipaddress.ipv6any) is preferred to [Any](/dotnet/api/system.net.ipaddress.any) because `Any` is less performant than `IPv6Any`. In some cases, `Any` may not work at all. `Any` has performance problems due to the [underlying System types implementation](https://github.com/dotnet/runtime/issues/82404).
 
 `127.0.0.1` is the IPv4 loopback address. `::1` is the IPv6 loopback address. `Any` is the wildcard address for IPv4. `IPv6Any` is the wildcard address for IPv6.
 
@@ -26,7 +26,7 @@ Current behavior with with IPv6 when using  HTTP/1.x or HTTP/2.0:
 * `localhost` resolves to `[::1]`.
 * `[::1]` isn't accepted by the server, which forces a retry using `127.0.0.1`, creating a repeated cycle.
 
-Using `Any` with the preceding conditions is reported with a diagnostic message:
+Using `Any` with the preceding conditions reports the `ASP0028` diagnostic message:
 
 ```csharp
 .UseKestrel().ConfigureKestrel(options =>
@@ -51,7 +51,7 @@ For the problematic code, replace `Any` with `IPv6Any`:
 })
 ```
 
-Alternatively, use the `ListenAnyIP` method without specifying any argument:
+Alternatively, use the [ListenAnyIP](https://source.dot.net/#Microsoft.AspNetCore.Server.Kestrel.Core/KestrelServerOptions.cs,1c84a7db2c1f6892) method without specifying any argument:
 
 ```diff
 .UseKestrel().ConfigureKestrel(options =>
@@ -63,6 +63,6 @@ Alternatively, use the `ListenAnyIP` method without specifying any argument:
 
 ## When to suppress warnings
 
-The `ASP0028` diagnostic has a Information level severity. Suppress warnings if your intention is to disable `IPv6` usage completely on the server, although this comes with the risk of the performance problems mentions in this article
+The `ASP0028` diagnostic has a Information level severity. Suppress warnings if your intention is to disable `IPv6` usage completely on the server, although doing so risks the performance problems mentioned in this article.
 
 `IPv6` can be disabled either system-wide, or for .NET only via the [AppCtx switch or environment variable](https://devblogs.microsoft.com/dotnet/dotnet-6-networking-improvements/#an-option-to-globally-disable-ipv6)