Fix Markdown syntax issues

Author: github-actions[bot]

TROUBLESHOOTING.md

@@ -43,39 +43,45 @@ ERROR: Python is not installed or not in PATH
 ```
 
 **Solution**: 
-- Install Python 3.8+ from https://www.python.org/downloads/
+
+- Install Python 3.8+ from <https://www.python.org/downloads/>
 - Ensure Python is added to your system PATH during installation
 - Verify installation: `python --version`
 
 ## Virtual Environment Creation Failed
+
 ```
 ERROR: Failed to create virtual environment
 ```
 
 **Solution**: 
+
 - Ensure you have write permissions to the `src` directory
 - Try deleting existing `venv` folder: `Remove-Item -Recurse -Force venv`
 - Check if `python -m venv` works manually: `python -m venv test_venv`
 - On Windows, ensure your execution policy allows script execution
 
 ## Package Installation Failed
+
 ```
 ERROR: Could not install packages due to an OSError
 ```
 
 **Solution**:
+
 - Update pip: `python -m pip install --upgrade pip`
 - Clear pip cache: `pip cache purge`
 - Try installing with `--no-cache-dir`: `pip install --no-cache-dir -r requirements.txt`
 - For Windows + pandas issues, use pre-built wheels by ensuring `pandas>=2.2.2` in requirements.txt
 
-
 ## Not Logged into Azure CLI
+
 ```
 ERROR: Please run 'az login' to setup account
 ```
 
 **Solution**:
+
 ```powershell
 # Login to Azure CLI
 az login
@@ -88,18 +94,20 @@ az account set --subscription <subscription-id>
 ```
 
 ## AAD Authentication Failed
+
 ```
 DefaultAzureCredential failed to retrieve a token
 ```
 
 **Solution**:
+
 1. Ensure you're logged into Azure CLI: `az login`
 2. Check your account has proper permissions
 3. Verify the resource exists and you have access
 4. Try clearing Azure credentials cache: `az account clear` then `az login` again
 
-
 ## Local Authorization Disabled Error
+
 ```
 ERROR: Local Authorization is disabled. Use an AAD token to authorize all requests.
 ```
@@ -128,6 +136,7 @@ az account set --subscription <subscription-id>
 > If your Cosmos DB has public network access disabled, your local machine or Codespace VM cannot connect.
 
 **Solution via Azure Portal**:
+
 - Navigate to your Cosmos DB account in the Azure portal
 - Select **Networking** from the Settings menu
 - Ensure **Public network access** is set to **All networks**
@@ -136,6 +145,7 @@ az account set --subscription <subscription-id>
 - Try running the script again
 
 **Solution via Azure CLI**:
+
 ```powershell
 az cosmosdb update \
   --name <cosmos-account-name> \
@@ -146,10 +156,12 @@ az cosmosdb update \
 - Insufficient Permissions: Your Azure account needs appropriate role assignments on the Cosmos DB account.
 
 **Required roles**:
+
 - `Cosmos DB Built-in Data Contributor` (for read/write access)
 - Or `Contributor` at the resource group level
 
 **Solution via Azure CLI**:
+
 ```powershell
 # Get your user object ID
 $userId = (az ad signed-in-user show --query id -o tsv)
@@ -164,18 +176,20 @@ az cosmosdb sql role assignment create \
 ```
 
 ## Connection Timeout
+
 ```
 ERROR: Request timeout
 ```
 
 **Solution**:
+
 - Check your network connection
 - Verify Cosmos DB firewall settings allow your IP address
 - Ensure public network access is enabled (see above)
-- Check if Azure services are experiencing outages: https://status.azure.com/
-
+- Check if Azure services are experiencing outages: <https://status.azure.com/>
 
 ## CSV File Not Found
+
 ```
 WARNING: CSV data file not found at data/updated_product_catalog(in).csv
 ```
@@ -188,45 +202,53 @@ curl -o src/data/updated_product_catalog(in).csv https://raw.githubusercontent.c
 ```
 
 ## CSV Parsing Error
+
 ```
 ERROR: Error tokenizing data. C error: Expected X fields, saw Y
 ```
 
 **Solution**:
+
 - Ensure CSV fields with commas are properly quoted
 - Check for special characters or encoding issues
 - Verify the CSV has the correct number of columns (6): ProductID, ProductName, ProductCategory, ProductDescription, Price, ImageUrl
 - Try opening the CSV in a text editor to check for formatting issues
 
 ## Environment File Missing
+
 ```
 ERROR: .env file not found
 ```
 
 **Solution**:
+
 ```bash
 # Run Terraform to generate the .env file
 cd terraform-infrastructure
 terraform apply -auto-approve
 ```
 
 ## Failed to Authenticate to Cosmos DB
+
 ```
 ERROR: Failed to authenticate to Cosmos DB using DefaultAzureCredential and no valid COSMOS_DB_KEY was provided
 ```
 
 **Solution**: 
+
 - Ensure your `.env` file is properly generated with correct keys
 - Run `terraform apply` again if needed
 - Check that `COSMOS_DB_ENDPOINT` and `COSMOS_DB_KEY` are set correctly in `.env`
 - The script will automatically try AAD authentication first, then fall back to key-based auth
 
 ## Resource Already Exists
+
 ```
 ERROR: A resource with the ID already exists
 ```
 
 **Solution**:
+
 - Import the existing resource: `terraform import <resource_type>.<name> <azure_resource_id>`
 - Or destroy and recreate: `terraform destroy` then `terraform apply`
 - Check for resources in other resource groups with the same name
@@ -238,6 +260,7 @@ ERROR: The client does not have authorization to perform action
 ```
 
 **Solution**:
+
 - Ensure your Azure account has `Contributor` or `Owner` role on the subscription or resource group
 - Check if specific Azure policies are blocking resource creation
 - Contact your Azure administrator to grant necessary permissions
@@ -249,6 +272,7 @@ ERROR: Error configuring the backend "azurerm"
 ```
 
 **Solution**:
+
 - Verify your Azure credentials are configured: `az login`
 - Check that the specified subscription exists and you have access
 - Ensure the backend storage account and container exist (if using remote state)
@@ -260,6 +284,7 @@ ERROR: Error acquiring the state lock
 ```
 
 **Solution**:
+
 ```bash
 # Force unlock (use with caution)
 terraform force-unlock <lock-id>
@@ -272,18 +297,21 @@ terraform force-unlock <lock-id>
 For more detailed error information:
 
 **Azure CLI**:
+
 ```powershell
 az <command> --debug
 ```
 
 **Python Scripts**:
 Set environment variable before running:
+
 ```powershell
 $env:AZURE_LOG_LEVEL = "DEBUG"
 python pipelines/script.py
 ```
 
 **Terraform**:
+
 ```bash
 export TF_LOG=DEBUG
 terraform apply

src/DATA_PIPELINE.md

@@ -11,7 +11,6 @@ Last updated: 2025-11-24
 
 > This automation handles the complete data pipeline setup for the Azure AI Shopping application.
 
-
 <details>
 <summary><b>Table of Content</b> (Click to expand)</summary>
 
@@ -29,15 +28,14 @@ Last updated: 2025-11-24
 
 </details>
 
-
 > [!NOTE]
 > What It Does? The data pipeline automation performs the following tasks:
+>
 > 1. **Creates Python Virtual Environment**: Sets up an isolated Python environment with all required dependencies
 > 2. **Imports Data to Cosmos DB**: Loads product catalog data from CSV into Cosmos DB container
 > 3. **Creates Azure AI Search Index**: Sets up a search index with vector search capabilities
 > 4. **Imports Data to Search**: Populates the search index from Cosmos DB using an indexer
 
-
 <details>
 <summary><b> Prerequisites: </b> (Click to expand)</summary>
 
@@ -68,6 +66,7 @@ terraform apply -auto-approve
 ```
 
 This will:
+
 - Deploy all Azure resources
 - Create AI model deployments
 - Generate `.env` file
@@ -76,17 +75,20 @@ This will:
 > Option 2: Run Manually → If you prefer to run the data pipeline manually or separately:
 
 1. **Ensure `.env` file exists** (created by Terraform):
+
    ```bash
    cd terraform-infrastructure
    terraform apply -auto-approve
    ```
 
 2. **Navigate to src directory**:
+
    ```bash
    cd ../src
    ```
 
 3. **Create virtual environment and install dependencies**:
+
    ```powershell
    python -m venv venv
    .\venv\Scripts\Activate.ps1
@@ -95,6 +97,7 @@ This will:
    ```
 
 4. **Run pipeline scripts in order**:
+
    ```powershell
    # Step 1: Import data to Cosmos DB
    python pipelines/ingest_to_cosmos.py
@@ -115,6 +118,7 @@ src/data/updated_product_catalog(in).csv
 ```
 
 > Expected columns:
+
 - `ProductID`: Unique product identifier
 - `ProductName`: Product name
 - `ProductCategory`: Product category
@@ -147,7 +151,6 @@ curl -o src/data/updated_product_catalog(in).csv https://raw.githubusercontent.c
 
 </details>
 
-
 <details>
 <summary><b> pipelines/create_search_index.py </b> (Click to expand)</summary>
 
@@ -158,7 +161,6 @@ curl -o src/data/updated_product_catalog(in).csv https://raw.githubusercontent.c
 
 </details>
 
-
 <details>
 <summary><b> pipelines/create_search_index.py </b> (Click to expand)</summary>
 
@@ -196,7 +198,7 @@ curl -o src/data/updated_product_catalog(in).csv https://raw.githubusercontent.c
 
 > For detailed troubleshooting guidance, see [TROUBLESHOOTING.md](../TROUBLESHOOTING.md). Quick Reference: 
 
-- **Python Not Found**: Install Python 3.8+ from https://www.python.org/downloads/
+- **Python Not Found**: Install Python 3.8+ from <https://www.python.org/downloads/>
 - **CSV File Not Found**: Download the product catalog CSV file and place it in `src/data/` directory
 - **Authentication Errors**: Run `az login` and ensure you have proper permissions. See [TROUBLESHOOTING.md](../TROUBLESHOOTING.md#azure-authentication-issues) for detailed solutions.
 - **Virtual Environment Issues**: Delete `venv` folder and recreate. See [TROUBLESHOOTING.md](../TROUBLESHOOTING.md#python-environment-issues) for details.
@@ -236,6 +238,7 @@ AZURE_OPENAI_EMBEDDING_DEPLOYMENT=text-embedding-3-small
 > After running the pipeline, verify data was imported:
 
 ## Check Cosmos DB
+
 ```powershell
 az cosmosdb sql container show \
   --account-name <cosmos-account> \
@@ -245,6 +248,7 @@ az cosmosdb sql container show \
 ```
 
 ## Check Search Index
+
 ```powershell
 az search index show \
   --index-name products-index \
@@ -253,6 +257,7 @@ az search index show \
 ```
 
 ## Query Search Index
+
 ```powershell
 az search index show-statistics \
   --index-name products-index \