Update based on reported broken links in #20

msal-java-articles/advanced/azure-regions-and-regional-endpoints.md

@@ -13,9 +13,9 @@ In order to make use of regional endpoints, MSAL Java allows developers to eithe
 
 To enable regional endpoints in MSAL Java, two values must be set when creating your client application object:
 
-* Either set the [azureRegion](https://github.com/AzureAD/microsoft-authentication-library-for-java/blob/62927a1f32cfeceaba1afb1bdf982d05d6446823/src/main/java/com/microsoft/aad/msal4j/AbstractClientApplicationBase.java#L103) field to the short name for the Azure region your application is running in (such as `westus`), or set the [autoDetectRegion](https://github.com/AzureAD/microsoft-authentication-library-for-java/blob/62927a1f32cfeceaba1afb1bdf982d05d6446823/src/main/java/com/microsoft/aad/msal4j/AbstractClientApplicationBase.java#L99) field to `true`
+* Either set the [`azureRegion`](https://github.com/AzureAD/microsoft-authentication-library-for-java/blob/62927a1f32cfeceaba1afb1bdf982d05d6446823/src/main/java/com/microsoft/aad/msal4j/AbstractClientApplicationBase.java#L103) field to the short name for the Azure region your application is running in (such as `westus`), or set the [`autoDetectRegion`](https://github.com/AzureAD/microsoft-authentication-library-for-java/blob/62927a1f32cfeceaba1afb1bdf982d05d6446823/src/main/java/com/microsoft/aad/msal4j/AbstractClientApplicationBase.java#L99) field to `true`
   * If `azureRegion` is set then library will try to send requests to an endpoint using that specific region, whereas if `autoDetectRegion` is true then the library will try to detect the region for you based on some metadata that can be found in the Azure environment
-* Set the [sendx5c](https://github.com/AzureAD/microsoft-authentication-library-for-java/blob/main/msal4j-sdk/src/main/java/com/microsoft/aad/msal4j/ConfidentialClientApplication.java#L44) field to `true`
+* Set the [`sendx5c`](xref:com.microsoft.aad.msal4j.ConfidentialClientApplication.Builder.sendX5c(boolean)) field to `true`
   * This informs the service handling the auth request to send [SubjectName/Issuer (SNI)](https://github.com/AzureAD/microsoft-authentication-library-for-java/issues/219) information as part of the token request, which is required by the regional token service
 
 For some more background information on regions, check out [this documentation](/identity/microsoft-identity-platform/msal-net-regional-adoption). Although that doc is for MSAL .NET, the underlying ideas behind regions and how to use them are the same for MSAL Java.

msal-java-articles/advanced/national-clouds.md

@@ -5,7 +5,7 @@ description: "National clouds (aka Sovereign clouds) are physically isolated ins
 
 # National clouds
 
-National clouds (aka Sovereign clouds) are physically isolated instances of Azure. These regions of Azure are designed to make sure that data residency, sovereignty, and compliance requirements are honored within geographical boundaries.
+National clouds (also known as sovereign clouds) are physically isolated instances of Azure. These regions of Azure are designed to make sure that data residency, sovereignty, and compliance requirements are honored within geographical boundaries.
 
 In addition to the public cloud​, Azure Active Directory is deployed in the following National clouds:  
 
@@ -21,4 +21,4 @@ Note that enabling your application for sovereign clouds requires you to:
 
 More details in [Authentication in National Clouds](/azure/active-directory/develop/authentication-national-cloud)
 
-For convenience, the list of authentication endpoints for the national clouds can be found in the [AzureCloudEndpoint](https://github.com/AzureAD/microsoft-authentication-library-for-java/blob/main/msal4j-sdk/src/main/java/com/microsoft/aad/msal4j/AzureCloudEndpoint.java) enum, along with the endpoint for the global/public cloud.
+For convenience, the list of authentication endpoints for the national clouds can be found in the [`AzureCloudEndpoint`](xref:com.microsoft.aad.msal4j.AzureCloudEndpoint) enum, along with the endpoint for the global/public cloud.