Writer first pass for CI 7350

Author: ryanberg-aquent

support/azure/partner-solutions/astro/personal-email.md

@@ -15,18 +15,18 @@ ai-usage: ai-assisted
 
 # Unable to install Astro using a personal email
 
-If you're trying to install Apache Airflow on Astro from the Azure Marketplace using a personal email from a generic domain, you may encounter issues. This article explains why this happens and how to resolve it.
+If you're trying to install Apache Airflow on Astro from the Microsoft Azure Marketplace using a personal email from a generic domain, you can encounter issues. This article explains why this happens and how to resolve them.
 
 ## Prerequisites
 
 - Access to the Azure portal.
-- An email address associated with a unique domain (such as work or school).
+- An email address associated with a unique domain (like work or school).
 - Subscription owner permissions in Azure.
 
 ## Symptoms
 
-- Unable to proceed with Astro installation using a personal email (for example, Gmail, Yahoo, Outlook).
-- Error or warning indicating unsupported email domain.
+- You're unable to install Astro with a personal email (for example, Gmail, Yahoo, or Outlook).
+- You get an error or warning message indicating an unsupported email domain.
 
 ## Cause
 
@@ -35,5 +35,5 @@ Astro installation from the Azure Marketplace doesn't support personal emails fr
 ## Solution
 
 1. Use an email address with a unique domain (for example, your organization's email).
-1. Alternatively, create a new user in Azure with a unique domain and assign subscription owner permissions.
-1. Retry the Astro installation from the Azure Marketplace.
+2. Alternatively, create a new user in Azure with a unique domain and assign subscription owner permissions.
+3. Retry the Astro installation from the Azure Marketplace.

support/azure/partner-solutions/astro/resource-creation.md

@@ -14,26 +14,26 @@ ai-usage: ai-assisted
 
 # Can't create Astro resource in Azure
 
-This article helps you resolve common issues that you might encounter when you try to create Astro resources in Microsoft Azure. These issues include permission errors and missing user profile information.
+This article helps you resolve common issues that you can encounter when you try to create Astro resources in Microsoft Azure. These issues include permission errors and missing user profile information.
 
 ## Prerequisites
 
-- You must have **Owner** access on the Azure subscription to set up Astro integration.
+- You must have `Owner` access on the Azure subscription to set up Astro integration.
 - Make sure that your user profile in Azure contains all required business information.
 
 ## Symptoms
 
-- When you try to create an Astro resource, you receive an error message that indicates that you're not a subscription owner.
+- When you try to create an Astro resource, you get an error message that indicates that you're not a subscription owner.
 - You can't create an Astro resource because of missing details in your user profile.
 
 ## Cause 1: Not a subscription owner
 
-Only users who have _Owner_ access on the Azure subscription can set up the Astro integration.
+Only users who have `Owner` access on the Azure subscription can set up the Astro integration.
 
 ### Solution 1
 
 1. Verify your access level on the Azure subscription.
-1. If you don't have **Owner** access, ask your Azure administrator to grant you the required permissions before you start the integration setup.
+2. If you don't have `Owner` access, ask your Azure admin to grant you the required permissions before you start the integration setup.
 
 ## Cause 2: Missing details in user profile
 
@@ -43,12 +43,12 @@ Your user profile has to be updated to include key business information for Astr
 
 1. In the Azure portal, select **Users**, and fill out the required details.
 
-1. Search for your username in the user information screen.
+2. Search for your username in the user information screen.
 
-1. Edit **UserInformation** to make sure that all required fields are completed.
+3. Edit **UserInformation** to make sure that all required fields are completed.
 
 ## Additional troubleshooting
 
 - If the deployment process takes more than three hours to complete, contact support.
-- If the deployment fails and the Astro resource has a status of **Failed**, delete the resource. After deletion, try to create the resource again.
-- If you get a **DeploymentFailed error**, check the status of your Azure subscription. Make sure it isn't suspended and doesn't have any billing issues.
+- If the deployment fails and the Astro resource has a status of `Failed`, delete the resource. After deletion, try to create the resource again.
+- If you get a DeploymentFailed error message, check the status of your Azure subscription. Make sure it isn't suspended and doesn't have any billing issues.

support/azure/partner-solutions/astro/single-sign-on.md

@@ -1,6 +1,6 @@
 ---
-title: Unable to use Single sign-on in Astronomer portal
-description: "Troubleshoot issues with Single sign-on (SSO) for the Astronomer portal in Azure, including consent and email requirements."
+title: Unable to use single sign-on in Astronomer portal
+description: "Troubleshoot issues with single sign-on (SSO) for the Astronomer portal in Azure, including consent and email requirements."
 author: ProfessorKendrick
 ms.author: jarrettr
 ms.reviewer: kkendrick
@@ -9,13 +9,13 @@ ms.topic: troubleshooting-problem-resolution
 ms.date: 09/04/2025
 ai-usage: ai-assisted
 
-#customer intent: As an Azure administrator, I want to resolve SSO issues with Astronomer so that users can access the portal securely.
+#customer intent: As an Azure admin, I want to resolve SSO issues with Astronomer so that users can access the portal securely.
 
 ---
 
-# Unable to use Single sign-on in Astronomer portal
+# Unable to use single sign-on in Astronomer portal
 
-This article helps you troubleshoot and resolve issues with Single sign-on (SSO) when accessing the Astronomer portal in Azure. If SSO isn't working, follow the steps in this guide to identify and fix common problems related to email, consent, and tenant settings.
+This article helps you troubleshoot and resolve issues with single sign-on (SSO) when accessing the Astronomer portal in Microsoft Azure. If SSO isn't working, follow these steps to identify and fix common problems related to email, consent, and tenant settings.
 
 ## Prerequisites
 
@@ -25,16 +25,16 @@ This article helps you troubleshoot and resolve issues with Single sign-on (SSO)
 
 ## Symptoms
 
-- Unable to sign in to the Astronomer portal using SSO.
-- Prompted for both Admin and User consent during first-time login.
-- Error messages related to email or consent.
+- You're unable to sign in to the Astronomer portal using SSO.
+- You're prompted for both **Admin** and **User consent** during first-time sign in.
+- You get error messages related to email or consent.
 
 ## Cause
 
-SSO issues can occur if you're using an incorrect email, haven't provided consent, or tenant settings prevent access.
+SSO issues can occur if you're using an incorrect email, haven't provided consent, or your tenant settings prevent access.
 
 ## Solution
 
 - Verify you're using the correct Microsoft Entra email for SSO.
-- Ensure you've consented to allow access for the Astronomer SaaS portal.
-- If you see both Admin and User consent screens during first-time login, check your tenant consent settings.
+- Ensure you've consented to allow access for the Astronomer software-as-a-service (SaaS) portal.
+- If you see both **Admin** and **User consent** screens during first-time sign in, check your tenant consent settings.