docs: Updated readme, added sample prompts, updated broken links

Author: Avijit-Microsoft

content-gen/README.md

@@ -183,8 +183,7 @@ BRAND_SECONDARY_COLOR=#107C10
 - [AZD Deployment Guide](docs/AZD_DEPLOYMENT.md) - Deploy with Azure Developer CLI
 - [Manual Deployment Guide](docs/DEPLOYMENT.md) - Step-by-step manual deployment
 - [Image Generation Configuration](docs/IMAGE_GENERATION.md) - DALL-E 3 and GPT-Image-1 setup
-- [API Reference](docs/API.md)
 
 ## License
 
-MIT License - See [LICENSE](LICENSE) for details.
+MIT License - See [LICENSE](../LICENSE) for details.

content-gen/docs/AZD_DEPLOYMENT.md

@@ -58,6 +58,11 @@ azd auth login
 
 # Login to Azure CLI (required for some post-deployment scripts)
 az login
+```
+ Alternatively, login to Azure using a device code (recommended when using VS Code Web):
+
+```
+az login --use-device-code
 ```
 
 ### 2. Initialize Environment
@@ -72,36 +77,7 @@ azd env new <environment-name>
 azd env new content-gen-dev
 ```
 
-### 3. Configure Parameters (Optional)
-
-The deployment has sensible defaults, but you can customize:
-
-```bash
-# Set the Azure region (default: eastus)
-azd env set AZURE_LOCATION swedencentral
-
-# Set AI Services region (must support your models)
-azd env set AZURE_ENV_OPENAI_LOCATION swedencentral
-
-# GPT Model configuration
-azd env set gptModelName gpt-4o
-azd env set gptModelVersion 2024-11-20
-azd env set gptModelDeploymentType GlobalStandard
-azd env set gptModelCapacity 50
-
-# Image generation model (dalle-3 or gpt-image-1)
-azd env set imageModelChoice gpt-image-1
-azd env set dalleModelCapacity 1
-
-# Embedding model
-azd env set embeddingModel text-embedding-3-large
-azd env set embeddingDeploymentCapacity 50
-
-# Azure OpenAI API version
-azd env set azureOpenaiAPIVersion 2024-12-01-preview
-```
-
-### 4. Choose Deployment Configuration
+### 3. Choose Deployment Configuration
 
 The [`infra`](../infra) folder contains the [`main.bicep`](../infra/main.bicep) Bicep script, which defines all Azure infrastructure components for this solution.
 
@@ -124,7 +100,7 @@ Before running `azd up`, copy the contents from the production configuration fil
 5. Select all existing content (Ctrl+A) and paste the copied content (Ctrl+V).
 6. Save the file (Ctrl+S).
 
-### 5. Deploy
+### 4. Deploy
 
 ```bash
 azd up
@@ -139,25 +115,6 @@ This single command will:
 6. **Configure** RBAC and Cosmos DB roles
 7. **Upload** sample data and create the search index
 
-## Deployment Parameters Reference
-
-| Parameter | Default | Description |
-|-----------|---------|-------------|
-| `AZURE_LOCATION` | eastus | Primary Azure region |
-| `azureAiServiceLocation` | eastus | Region for AI Services (must support chosen models) |
-| `gptModelName` | gpt-4o | GPT model for content generation |
-| `gptModelVersion` | 2024-11-20 | Model version |
-| `gptModelDeploymentType` | GlobalStandard | Deployment type |
-| `gptModelCapacity` | 50 | TPM capacity (in thousands) |
-| `imageModelChoice` | dalle-3 | Image model: `dalle-3` or `gpt-image-1` |
-| `dalleModelCapacity` | 1 | Image model capacity |
-| `embeddingModel` | text-embedding-3-large | Embedding model |
-| `embeddingDeploymentCapacity` | 50 | Embedding TPM capacity |
-| `enablePrivateNetworking` | false | Enable VNet and private endpoints |
-| `enableMonitoring` | false | Enable Log Analytics + App Insights |
-| `enableScalability` | false | Enable auto-scaling |
-| `enableRedundancy` | false | Enable zone/geo redundancy |
-
 ## Using Existing Resources
 
 ### Reuse Existing AI Foundry Project
@@ -174,13 +131,6 @@ azd env set AZURE_EXISTING_AI_PROJECT_RESOURCE_ID "/subscriptions/<sub-id>/resou
 azd env set AZURE_ENV_LOG_ANALYTICS_WORKSPACE_ID "/subscriptions/<sub-id>/resourceGroups/<rg>/providers/Microsoft.OperationalInsights/workspaces/<workspace-name>"
 ```
 
-### Use Existing Container Registry
-
-```bash
-# Set the name of your existing ACR
-azd env set ACR_NAME myexistingacr
-```
-
 ## Post-Deployment
 
 After `azd up` completes, you'll see output like:
@@ -212,51 +162,6 @@ azd env get-value WEB_APP_URL
 azd env get-value RESOURCE_GROUP_NAME
 ```
 
-## Day-2 Operations
-
-### Update the Application
-
-After making code changes:
-
-```bash
-# Rebuild and redeploy everything
-azd up
-
-# Or just redeploy (no infra changes)
-azd deploy
-```
-
-### Update Only the Backend (Container)
-
-```bash
-# Get ACR and ACI names
-ACR_NAME=$(azd env get-value ACR_NAME)
-ACI_NAME=$(azd env get-value CONTAINER_INSTANCE_NAME)
-RG_NAME=$(azd env get-value RESOURCE_GROUP_NAME)
-
-# Build and push new image
-az acr build --registry $ACR_NAME --image content-gen-app:latest --file ./src/WebApp.Dockerfile ./src
-
-# Restart ACI to pull new image
-az container restart --name $ACI_NAME --resource-group $RG_NAME
-```
-
-### Update Only the Frontend
-
-```bash
-cd src/app/frontend
-npm install && npm run build
-
-cd ../frontend-server
-zip -r frontend-deploy.zip static/ server.js package.json package-lock.json
-
-az webapp deploy \
-  --resource-group $(azd env get-value RESOURCE_GROUP_NAME) \
-  --name $(azd env get-value APP_SERVICE_NAME) \
-  --src-path frontend-deploy.zip \
-  --type zip
-```
-
 ### View Logs
 
 ```bash
@@ -331,7 +236,7 @@ Error: az acr build failed
 **Solution**: Check the Dockerfile and ensure all required files are present:
 ```bash
 # Manual build for debugging
-cd src
+cd src/app
 docker build -f WebApp.Dockerfile -t content-gen-app:test .
 ```
 
@@ -403,6 +308,6 @@ When `enablePrivateNetworking` is enabled:
 
 ## Related Documentation
 
-- [Manual Deployment Guide](DEPLOYMENT.md)
+- [Deployment Guide](DEPLOYMENT.md)
 - [Image Generation Configuration](IMAGE_GENERATION.md)
 - [Azure Developer CLI Documentation](https://learn.microsoft.com/azure/developer/azure-developer-cli/)

content-gen/docs/DEPLOYMENT.md

@@ -134,13 +134,12 @@ When you start the deployment, most parameters will have **default values**, but
 | ------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ---------------------- |
 | **Azure Region**                            | The region where resources will be created.                                                               | *(empty)*              |
 | **Environment Name**                        | A **3–20 character alphanumeric value** used to generate a unique ID to prefix the resources.             | env\_name              |
-| **GPT Model**                               | Choose from **gpt-4, gpt-4o, gpt-4o-mini**.                                                               | gpt-4o-mini            |
-| **GPT Model Version**                       | The version of the selected GPT model.                                                                    | 2024-07-18             |
+| **GPT Model**                               | Choose from **gpt-4, gpt-4o, gpt-4o-mini, gpt-5.1**.                                                               | gpt-5.1           |
+| **GPT Model Version**                       | The version of the selected GPT model.                                                                    | 2025-11-13            |
 | **OpenAI API Version**                      | The Azure OpenAI API version to use.                                                                      | 2025-01-01-preview     |
-| **GPT Model Deployment Capacity**           | Configure capacity for **GPT models** (in thousands).                                                     | 30k                    |
-| **DALL-E Model**                            | DALL-E model for image generation.                                                                        | dall-e-3               |
+| **GPT Model Deployment Capacity**           | Configure capacity for **GPT models** (in thousands).                                                     | 150k                    |
+| **Image Model**                            | Choose from **dall-e-3, gpt-image-1, gpt-image-1.5**                                                                          | gpt-image-1             |
 | **Image Tag**                               | Docker image tag to deploy. Common values: `latest`, `dev`, `hotfix`.                                     | latest                 |
-| **Use Local Build**                         | Boolean flag to determine if local container builds should be used.                                       | false                  |
 | **Existing Log Analytics Workspace**        | To reuse an existing Log Analytics Workspace ID.                                                          | *(empty)*              |
 | **Existing Azure AI Foundry Project**       | To reuse an existing Azure AI Foundry Project ID instead of creating a new one.                           | *(empty)*              |
 
@@ -171,30 +170,14 @@ Once you've opened the project in [Codespaces](#github-codespaces), [Dev Contain
    
     Follow steps in [App Authentication](./AppAuthentication.md) to configure authentication in app service. Note: Authentication changes can take up to 10 minutes.
 
-2. **Assign RBAC Roles (if needed)**
-
-    If you encounter 401/403 errors, run the RBAC assignment script and wait 5-10 minutes for propagation:
-
-    ```shell
-    bash ./scripts/assign_rbac_roles.sh
-    ```
-
-3. **Deleting Resources After a Failed Deployment**  
+2. **Deleting Resources After a Failed Deployment**  
     - Follow steps in [Delete Resource Group](./DeleteResourceGroup.md) if your deployment fails and/or you need to clean up the resources.
 
 ## Troubleshooting
 
 <details>
   <summary><b>Common Issues and Solutions</b></summary>
 
-### 401 Unauthorized Errors
-
-**Symptom**: API calls return 401 errors
-
-**Cause**: Missing RBAC role assignments
-
-**Solution**: Run `assign_rbac_roles.sh` and wait 5-10 minutes for propagation
-
 ### 403 Forbidden from Cosmos DB
 
 **Symptom**: Cosmos DB operations fail with 403
@@ -230,56 +213,29 @@ az webapp config set -g $RESOURCE_GROUP -n <app-name> --http20-enabled false
 
 ### Image Generation Not Working
 
-**Symptom**: DALL-E requests fail
+**Symptom**: DALL-E/GPT-Image requests fail
 
-**Cause**: Missing DALL-E model deployment or incorrect endpoint
+**Cause**: Missing DALL-E/GPT-Image model deployment or incorrect endpoint
 
 **Solution**: 
-1. Verify DALL-E 3 deployment exists in Azure OpenAI resource
-2. Check `AZURE_OPENAI_DALLE_ENDPOINT` and `AZURE_OPENAI_DALLE_DEPLOYMENT` environment variables
+1. Verify DALL-E 3 or GPT-Image-1 or GPT-Image-1.5 deployment exists in Azure OpenAI resource
+2. Check `AZURE_OPENAI_IMAGE_MODEL` environment variable
 
 </details>
 
-## Environment Variables Reference
-
-<details>
-  <summary><b>Backend Environment Variables (ACI)</b></summary>
-
-| Variable | Description | Example |
-|----------|-------------|---------|
-| AZURE_OPENAI_ENDPOINT | GPT model endpoint | https://ai-account.cognitiveservices.azure.com/ |
-| AZURE_OPENAI_DEPLOYMENT_NAME | GPT deployment name | gpt-4o-mini |
-| AZURE_OPENAI_DALLE_ENDPOINT | DALL-E endpoint | https://dalle-account.cognitiveservices.azure.com/ |
-| AZURE_OPENAI_DALLE_DEPLOYMENT | DALL-E deployment name | dall-e-3 |
-| COSMOS_ENDPOINT | Cosmos DB endpoint | https://cosmos.documents.azure.com:443/ |
-| COSMOS_DATABASE | Database name | content-generation |
-| AZURE_STORAGE_ACCOUNT_NAME | Storage account | storagecontentgen |
-| AZURE_STORAGE_CONTAINER | Product images container | product-images |
-| AZURE_STORAGE_GENERATED_CONTAINER | Generated images container | generated-images |
-
-</details>
-
-<details>
-  <summary><b>Frontend Environment Variables (App Service)</b></summary>
-
-| Variable | Description | Example |
-|----------|-------------|---------|
-| BACKEND_URL | Backend API URL | http://backend.contentgen.internal:8000 |
-| WEBSITES_PORT | App Service port | 3000 |
-
-</details>
+## Sample Workflow
 
-## Sample Prompts
+To get started with the Content Generation solution, follow these steps:
 
-To help you get started, here are some **sample prompts** you can use with the Content Generation Solution:
+1. **Task:** From the welcome screen, select one of the suggested prompts. Sample prompts include:
+   - *"I need to create a social media post about paint products for home remodels. The campaign is titled 'Brighten Your Springtime' and the audience is new homeowners. I need marketing copy plus an image."*
+   - *"Generate a social media campaign with ad copy and an image. This is for 'Back to School' and the audience is parents of school age children. Tone is playful and humorous."*
 
-- "Create a product description for a new eco-friendly water bottle"
-- "Generate marketing copy for a summer sale campaign"
-- "Write social media posts promoting our latest product launch"
-- "Create an image for a blog post about sustainable living"
-- "Generate a product image showing a modern office setup"
+2. **Task:** Click the **"Confirm Brief"** button.
+   > **Observe:** The system analyzes the creative brief to provide suggestions later.
 
-These prompts serve as a great starting point to explore the solution's capabilities with text generation, image generation, and content management.
+3. **Task:** Select a product from the product list, then click **"Generate Content"**.
+   > **Observe:** Enters "Thinking Process" with a "Generating Content.." spinner. Once complete, the detailed output is displayed.
 
 ## Architecture Overview
 

content-gen/docs/DeleteResourceGroup.md

@@ -0,0 +1,51 @@
+# Deleting Resources After a Failed Deployment in Azure Portal
+
+If your deployment fails and you need to clean up the resources manually, follow these steps in the Azure Portal.
+
+---
+
+## **1. Navigate to the Azure Portal**
+1. Open [Azure Portal](https://portal.azure.com/).
+2. Sign in with your Azure account.
+
+---
+
+## **2. Find the Resource Group**
+1. In the search bar at the top, type **"Resource groups"** and select it.
+2. Locate the **resource group** associated with the failed deployment.
+
+![Resource Groups](images/resourcegroup.png)
+
+![Resource Groups](images/resource-groups.png)
+
+---
+
+## **3. Delete the Resource Group**
+1. Click on the **resource group name** to open it.
+2. Click the **Delete resource group** button at the top.
+
+![Delete Resource Group](images/DeleteRG.png)
+
+3. Type the resource group name in the confirmation box and click **Delete**.
+
+📌 **Note:** Deleting a resource group will remove all resources inside it.
+
+---
+
+## **4. Delete Individual Resources (If Needed)**
+If you don’t want to delete the entire resource group, follow these steps:
+
+1. Open **Azure Portal** and go to the **Resource groups** section.
+2. Click on the specific **resource group**.
+3. Select the **resource** you want to delete (e.g., App Service, Storage Account).
+4. Click **Delete** at the top.
+
+![Delete Individual Resource](images/deleteservices.png)
+
+---
+
+## **5. Verify Deletion**
+- After a few minutes, refresh the **Resource groups** page.
+- Ensure the deleted resource or group no longer appears.
+
+📌 **Tip:** If a resource fails to delete, check if it's **locked** under the **Locks** section and remove the lock.

content-gen/docs/QuotaCheck.md

@@ -72,7 +72,7 @@ The final table lists regions with available quota. You can select any of these
    **To check quota for the deployment**
 
     ```sh
-    curl -L -o quota_check_params.sh "https://raw.githubusercontent.com/microsoft/content-generation-solution-accelerator/main/content-gen/infra/script/quota_check_params.sh"
+    curl -L -o quota_check_params.sh "https://raw.githubusercontent.com/microsoft/content-generation-solution-accelerator/main/content-gen/infra/scripts/quota_check_params.sh"
     chmod +x quota_check_params.sh
     ./quota_check_params.sh
     ```
@@ -82,9 +82,9 @@ The final table lists regions with available quota. You can select any of these
 1. Open the terminal in VS Code or Codespaces.
 2. If you're using VS Code, click the dropdown on the right side of the terminal window, and select `Git Bash`.
    ![git_bash](images/git_bash.png)
-3. Navigate to the `content-gen/infra/script` folder where the script files are located and make the script as executable:
+3. Navigate to the `content-gen/infra/scripts` folder where the script files are located and make the script as executable:
    ```sh
-    cd content-gen/infra/script
+    cd content-gen/infra/scripts
     chmod +x quota_check_params.sh
     ```
 4. Run the appropriate script based on your requirement: