docs edits

Author: paigecalvert

docs/vendor/custom-domains-using.md

@@ -6,6 +6,12 @@ For information about adding and managing custom domains with the Vendor API v3,
 
 For more information about custom domains, see [About Custom Domains](custom-domains).
 
+## Known Issue
+
+If you use a custom domain for the Replicated Enterprise Portal and any of your customers use link transformers such as Microsoft Defender Safe Links, then there is a known issue where legitimate URLs in emails generated by the Enterprise Portal can break due to rewrapping. To avoid this issue, request a "Do not rewrite the following URLs" exclusion policy for your custom Enterprise Portal domain.
+
+For more information, see [About the Enterprise Portal](enterprise-portal-about).
+
 ## Add a Custom Domain in the Vendor Portal {#add-domain}
 
 To add and verify a custom domain:
@@ -14,6 +20,10 @@ To add and verify a custom domain:
 
 1. In the **Add custom domain** dropdown, select the target Replicated endpoint.
 
+    :::note
+    There is a known issue when using a custom domain for the Enterprise Portal if any of your customers use link transformers such as Microsoft Defender Safe Links. See [Known Issue](#known-issue) above.
+    :::
+
     The **Configure a custom domain** wizard opens.
 
     <img src="/images/custom-domains-download-configure.png" alt="custom domain wizard" width="500"/>

docs/vendor/enterprise-portal-about.mdx

@@ -27,6 +27,8 @@ The following diagram shows how customers can use the Enterprise Portal to acces
 
 As shown in the diagram above, your licensed customers can access the installation and update instructions for one or more application releases by logging in to the Enterprise Portal. The Enterprise Portal tracks the customer's installation attempts and progress, and shares those insights back to the Vendor Portal. After installing, customers can also upload support bundles in the Enterprise Portal. Support bundles uploaded to the Enterprise Portal are automatically made available to you in the Vendor Portal. 
 
+You can enable and disable access to the Enterprise Portal for all customers, or on a per-customer basis. For more information about how to enable access, see [Manage Customer Access](/vendor/enterprise-portal-invite#manage-ep-access).
+
 For information about using the Enterprise Portal, see [Access and Use the Enterprise Portal](enterprise-portal-use).
 
 ## Limitations
@@ -53,10 +55,6 @@ For more information about customizing the Enterprise Portal, see [Customize the
 
 For information about how to set a custom domain for the Enterprise Portal, see [Use Custom Domains](/vendor/custom-domains-using). 
 
-For any enterprise customers using link transformers such as Microsoft Defender Safe Links, you may need to request a "Do not rewrite the following URLs" exclusion policy for your custom Enterprise Portal domain in order to prevent issues with rewrapping breaking legitimate URLs in Enterprise generated emails.
-
-You can enable and disable access to the Enterprise Portal for all customers, or on a per-customer basis. For more information about how to enable access, see [Manage Customer Access](/vendor/enterprise-portal-invite#manage-ep-access).
-
 ## About Instance Reporting with the Enterprise Portal
 
 This section describes the instance reporting functionality of the Enterprise Portal.