microsoft · gpickett · Apr 30, 2025 · Apr 22, 2025 · Apr 23, 2025 · Apr 23, 2025
diff --git a/README.md b/README.md
diff --git a/azure.yaml b/azure.yaml
@@ -1,3 +1,2 @@
 # yaml-language-server: $schema=https://raw.githubusercontent.com/Azure/azure-dev/main/schemas/v1.0/azure.yaml.json
-name: multi-agent-custom-automation-engine-solution-accelerator
-
+name: multi-agent-custom-automation-engine-solution-accelerator
diff --git a/documentation/AzureAccountSetUp.md b/documentation/AzureAccountSetUp.md
@@ -0,0 +1,14 @@
+## Azure account setup
+
+1. Sign up for a [free Azure account](https://azure.microsoft.com/free/) and create an Azure Subscription.
+2. Check that you have the necessary permissions:
+    * Your Azure account must have `Microsoft.Authorization/roleAssignments/write` permissions, such as [Role Based Access Control Administrator](https://learn.microsoft.com/azure/role-based-access-control/built-in-roles#role-based-access-control-administrator-preview), [User Access Administrator](https://learn.microsoft.com/azure/role-based-access-control/built-in-roles#user-access-administrator), or [Owner](https://learn.microsoft.com/azure/role-based-access-control/built-in-roles#owner).
+    * Your Azure account also needs `Microsoft.Resources/deployments/write` permissions on the subscription level.
+
+You can view the permissions for your account and subscription by following the steps below: 
+- Navigate to the [Azure Portal](https://portal.azure.com/) and click on `Subscriptions` under 'Navigation' 
+- Select the subscription you are using for this accelerator from the list. 
+    - If you try to search for your subscription and it does not come up, make sure no filters are selected.
+- Select `Access control (IAM)` and you can see the roles that are assigned to your account for this subscription. 
+    - If you want to see more information about the roles, you can go to the `Role assignments`
+     tab and search by your account name and then click the role you want to view more information about.
diff --git a/documentation/DeploymentGuide.md b/documentation/DeploymentGuide.md
diff --git a/documentation/LocalDeployment.md b/documentation/LocalDeployment.md
diff --git a/documentation/images/readme/business-scenario.png b/documentation/images/readme/business-scenario.png
diff --git a/documentation/images/readme/macae-architecture.png b/documentation/images/readme/macae-architecture.png
diff --git a/documentation/images/readme/quick-deploy.png b/documentation/images/readme/quick-deploy.png
diff --git a/documentation/images/readme/solution-overview.png b/documentation/images/readme/solution-overview.png
diff --git a/documentation/images/readme/supporting-documentation.png b/documentation/images/readme/supporting-documentation.png
diff --git a/next-steps.md b/next-steps.md
@@ -17,7 +17,8 @@ To troubleshoot any issues, see [troubleshooting](#troubleshooting).
 
 ### Configure environment variables for running services
 
-Configure environment variables for running services by updating `settings` in [main.parameters.json](./infra/main.parameters.json).
+Environment variables can be configured by modifying the `env` settings in [resources.bicep](./infra/resources.bicep).
+To define a secret, add the variable as a `secretRef` pointing to a `secrets` entry or a stored KeyVault secret.
 
 ### Configure CI/CD pipeline