Updated as per the comments

Author: Prekshith-Microsoft

docs/DeploymentGuide.md

@@ -212,8 +212,7 @@ azd up
 
 **⚠️ Deployment Issues:** If you encounter errors or timeouts, try a different region as there may be capacity constraints. For detailed error solutions, see our [Troubleshooting Guide](./TroubleShootingSteps.md).
 
-## Step 5: Post-Deployment Script
-
+## Step 5: Post Deployment Configuration
 The post deployment process is very straightforward and simplified via a single [deployment script](../Deployment/resourcedeployment.ps1) that completes in approximately 20-30 minutes:
 
 ### Automated Deployment Steps:
@@ -223,28 +222,117 @@ The post deployment process is very straightforward and simplified via a single
 - Docker build and push container images to Azure Container Registry.
 - Display the deployment result and following instructions.
 
-### 5.1 Script Execution
+### 5.1 Execute the Script
+
+#### 5.1.1 Open PowerShell, change directory where you code cloned, then run the deploy script:
+
+```shell
+cd .\Deployment\
+```
+
+#### 5.1.2 Choose the appropriate command based on your deployment method:
+
+**If you deployed using `azd up` command:**
+```shell
+.\resourcedeployment.ps1
+```
+
+**If you deployed using custom templates, ARM/Bicep deployments, or `az deployment group` commands:**
+```shell
+.\resourcedeployment.ps1 -ResourceGroupName "<your-resource-group-name>"
+```
+
+> **Note:** Replace `<your-resource-group-name>` with the actual name of the resource group containing your deployed Azure resources.
+
+> **💡 Tip**: Since this guide is for azd deployment, you'll typically use the first command without the `-ResourceGroupName` parameter.
+
+If you run into issue with PowerShell script file not being digitally signed, you can execute below command:
+
+```shell
+powershell.exe -ExecutionPolicy Bypass -File ".\resourcedeployment.ps1"
+```
+
+#### 5.1.3 You will be prompted for the following parameters with this Screen:
+
+<img src="./images/deployment/Deployment_Input_Param_01.png" width="900" alt-text="Input Parameters">
 
-1. Follow [Post Deployment Script Execution](./PostDeploymentConfiguration.md)
-2. Wait up to 20-30 minutes for completion of the script.
+##### 5.1.3.1 **Email** - used for issuing certificates in Kubernetes clusters from the [Let's Encrypt](https://letsencrypt.org/) service. Email address should be valid.
 
-### 5.2 Verify Deployment
+<img src="./images/deployment/Deployment_Login_02.png" width="900" alt-text="Login">
 
-1. Access your application using the URL from Step 5.1
+##### 5.1.3.2 You will be prompted to Login, Select a account and proceed to Login.
+
+##### 5.1.3.3 **GO !** - Post Deployment Script executes Azure Infrastructure configuration, Application code compile and publish into Kubernetes Cluster.
+
+##### 5.1.3.4 Deployment Complete
+
+#### 🥳🎉 First, congrats on finishing Deployment!
+Let's check the message and configure your model's TPM rate higher to get better performance.  
+You can check the Application URL from the final console message.  
+Don't miss this Url information. This is the application's endpoint URL and it should be used for your data importing process.
+
+<img src="./images/deployment/Deployment_Screen02.png" alt="Success Deployment" width="900">
+
+### 5.2 Manual Deployment Steps:
+**Create Content Filter** - Please follow below steps
+> * Navigate to project in Azure OpenAI, then go to Azure AI Foundry, select Safety + security
+> * Click on Create Content Filter and set the filters to a high threshold for the following categories:
+    ```
+    Hate, Sexual, Self-harm, Violence
+    ```
+> * Please select the checkbox of profanity
+> * Leave all other configurations at their default settings and click on create
+
+### 5.3 Configure Azure OpenAI Rate Limits
+
+> **Capacity Note:**
+> * The deployment script creates models with a setting of 1 token per minute (TPM) rate limit.
+> * Faster performance can be achieved by increasing the TPM limit with Azure AI Foundry.
+> * Capacity varies for [regional quota limits](https://learn.microsoft.com/en-us/azure/ai-services/openai/quotas-limits#regional-quota-limits) as well as for [provisioned throughput](https://learn.microsoft.com/en-us/azure/ai-services/openai/concepts/provisioned-throughput).
+> * As a starting point, we recommend the following quota threshold be set up for this service run.
+
+| Model Name             | TPM Threshold |
+|------------------------|---------------|
+| GPT-4.1-mini           | 100K TPM      |
+| text-embedding-3-large | 200K TPM      |
+
+> **⚠️ Warning:**  **Insufficient quota can cause failures during the upload process.** Please ensure you have the recommended capacity or request for additional capacity before start uploading the files.
+
+#### 5.3.1 Browse to the project in Azure AI Foundry, and select **each of the 2 models** within the `Deployments` menu:
+
+<img src="./images/deployment/Control_Model_TPM000.png" alt="Select Model" width="700">
+
+#### 5.3.2 Increase the TPM value for **each model** for faster report generation:
+
+<img src="./images/deployment/Control_Model_TPM001.png" alt="Set Token per minute" width="700">
+
+### 5.4 Data Uploading and Processing
+
+After increasing the TPM limit for each model, let's upload and process the sample documents.
+
+Execute this command:
+
+<img src="./images/deployment/Deployment_last_step.png" alt="Set Token per minute" width="700">
+
+### 5.5 Verify Deployment
+
+1. Access your application using the URL from [Step 5.1.3.4](#5134-deployment-complete)
 2. Confirm the application loads successfully
 3. Verify you can sign in with your authenticated account
 
-### 5.3 Test the Application
+### 5.6 Test the Application
 
 Follow the detailed workflow to test the migration functionality:
 
 **Quick Test Steps:**
-1. Login to the application using the URL from Step 5.1
+1. Login to the application using the URL from [Step 5.1.3.4](#5134-deployment-complete)
 2. In "Chat with documents" options, ask any questions related to uploaded documents
 3. Click on "Details" of any document and go to "chat" option
 4. Ask questions according to document content
 5. Review the responses
 
+📖 **Sample Questions:** For a comprehensive list of test scenarios and example questions, see [Sample Questions Guide](./SampleQuestions.md)
+
 ## Step 6: Clean Up (Optional)
 
 ### Remove All Resources

docs/SampleQuestions.md

@@ -0,0 +1,51 @@
+# Sample Questions
+
+## 1. Launch Web Experience
+- Open the web experience interface.
+- Navigate to the **document list**.
+- Scroll and page through the list to explore available documents.
+- Ask in chat: **“What are the main factors contributing to the current housing affordability issues?”**
+![chat response image](./images/SampleQustion.png)
+- Review the AI response for relevant insights.
+- Click one of the **suggested follow-up questions** and check the response.
+- Reset the chat by clicking **[New topic]**.
+---
+
+## 2. Housing Report Search & Comparison
+- Search for: **“Housing Report”**.
+- Observe the filtered list of documents.
+- Select **Annual Housing Report 2022** and **Annual Housing Report 2023**.
+  - Confirm the top panel shows **“2 Selected”**.
+- Ask in chat: **“Analyze the two annual reports and compare the positive and negative outcomes YoY. Show the results in a table.”**
+- Review the generated table for clarity and accuracy.
+
+---
+
+## 3. Detailed Review of Annual Housing Report 2023
+- Click **DETAILS** on **Annual Housing Report 2023**.
+- Review the **Extractive Summary** for accuracy.
+- Scroll to **pages 10 & 11**.
+- In the pop-up chat, ask:  
+  **“Can you summarize and compare the tables on page 10 and 11?”**
+- Review the summarized comparison.
+- Close the pop-up viewer.
+
+---
+
+## 4. Contracts Search & Analysis
+- Search for: **“Contracts”**.
+- Observe the filtered list of documents.
+- Select **3–4 handwritten contract documents**.
+- Ask in chat:  
+  **“Analyze these forms and create a table with all buyers, sellers, and corresponding purchase prices.”**
+- Review the table for correct buyer/seller names and purchase prices.
+
+---
+
+## 5. Contract Details & Liabilities
+- Click **DETAILS** on one of the handwritten contracts.
+- In the pop-up chat, ask:  
+  **“What liabilities is the buyer responsible for within the contract?”**
+- Review the response for specific obligations (e.g., fees, taxes, maintenance, contingencies).
+
+---