Update aad-b2c.md

msal-java-articles/advanced/aad-b2c.md

@@ -5,34 +5,39 @@ description: "You can use MSAL4J to sign-in users with social identities by usin
 
 # Use MSAL4J to sign-in users with social identities
 
-You can use MSAL4J to sign-in users with social identities by using [Azure AD B2C](https://aka.ms/aadb2c). AAD B2C is built around the notion of policies. In MSAL4J, specifying a policy translates to providing an authority.
-
-- When you instantiate the client application, you need to specify the policy in authority
+You can use MSAL4J to sign users in with social identities by using [Azure Active Directory B2C](https://aka.ms/aadb2c) (AAD B2C). AAD B2C is built around the notion of [policies](/azure/active-directory-b2c/custom-policy-overview). In MSAL4J, specifying a policy translates to providing an authority - when you instantiate a client application, you need to specify the policy in the authority configuration
 
 ## Authority for a B2C tenant and policy
 
-The authority to use is `https://login.microsoftonline.com/tfp/{tenant}/{policyName}` where:
+Generally, the authority to use is `https://login.microsoftonline.com/tfp/{tenant}/{policyName}`, where:
 
 - `tenant` is the name of the Azure AD B2C tenant
-- `policyName` the name of the policy to apply (for instance "b2c_1_susi" for sign-in/sign-up).
+- `policyName` the name of the policy to apply (for instance `b2c_1_susi` for sign-in/sign-up).
+
+>[!NOTE]
+>The current guidance from the Azure AD B2C team is to use `b2clogin.com` as the authority. For example, `https://{your-tenant-name}.b2clogin.com/tfp/{your-tenant-ID}/{policyname}`. For more information, see [Set redirect URLs to b2clogin.com for Azure Active Directory B2C](/azure/active-directory-b2c/b2clogin).
 
-The current guidance from B2C is to use `b2clogin.com` as the authority. For example, `https://{your-tenant-name}.b2clogin.com/tfp/{your-tenant-ID}/{policyname}`. For more information, see this [documentation](/azure/active-directory-b2c/b2clogin).
+## Limitations of the username and password flow
 
-## Limitations of the Username/Password flow
+If you are using username and password flows with MSAL4J, also known as Resource Owner Password Credentials (ROPC), be aware of the following limitations:
 
-- This only works for local accounts (where you register with B2C using an email or username). This flow does not work if federating to any of the IdPs supported by B2C (Facebook, Google, etc...).
-- Currently, there is no id_token returned from B2C when implementing the ROPC flow from MSAL. This means an Account object cannot be created, so in the cache, there will be no Account and no user. The AcquireTokenSilent flow will not work in this scenario. However, ROPC does not show a UI, so there will no impact to the user experience.
+- The flow only works for local accounts, where you register with AAD B2C using an email or username. This flow does not work if federating to any of the identity providers supported by B2C (Facebook, Google, etc.).
+- Currently, there is no `id_token` returned from B2C when implementing the ROPC flow from MSAL. This means an that an account object cannot be created, so in the cache, there will be no account and no user. The [`acquireTokenSilently`](xref:com.microsoft.aad.msal4j.AbstractClientApplicationBase.acquireTokenSilently(com.microsoft.aad.msal4j.SilentParameters)) flow will not work in this scenario. However, ROPC does not show a UI, so there will no impact to the user experience.
 
-## Instantiating the application
+## Instantiating an application
+
+For confidential client applications:
 
 ```java
  ConfidentialClientApplication cca = ConfidentialClientApplication.builder(APP_ID, credential)
-                    .b2cAuthority(B2C_AUTHORITY)
-                    .build();
+    .b2cAuthority(B2C_AUTHORITY)
+    .build();
 ```
 
+For public client applications:
+
 ```java
 PublicClientApplication pca = new PublicClientApplication.Builder(APP_ID)
-                .b2cAuthority(B2C_AUTHORITY)
-                .build();
+    .b2cAuthority(B2C_AUTHORITY)
+    .build();
 ```