comments after James' review

Author: TheovanKraay

articles/cosmos-db/TOC.yml

@@ -40,7 +40,7 @@
           href: gen-ai/knn-vs-ann.md
         - name: Multi-tenancy for vector search
           href: nosql/multi-tenancy-vector-search.md
-    - name: Generative AI
+    - name: AI Applications
       expanded: true
       items:
         - name: Quickstart - build a RAG chatbot

articles/cosmos-db/gen-ai/quickstart-rag-chatbot.md

@@ -48,6 +48,26 @@ Install the necessary Python packages to interact with Azure Cosmos DB and other
 
 Populate `sample_env_file.env` with the appropriate credentials for Azure Cosmos DB and Azure OpenAI.
 
+```env
+cosmos_uri = "https://<replace with cosmos db account name>.documents.azure.com:443/"
+cosmos_key = "<replace with cosmos db account key>"
+cosmos_database_name = "database"
+cosmos_collection_name = "vectorstore"
+cosmos_vector_property_name = "vector"
+cosmos_cache_database_name = "database"
+cosmos_cache_collection_name = "vectorcache"
+openai_endpoint = "<replace with azure openai endpoint>"
+openai_key = "<replace with azure openai key>"
+openai_type = "azure"
+openai_api_version = "2023-05-15"
+openai_embeddings_deployment = "<replace with azure openai embeddings deployment name>"
+openai_embeddings_model = "<replace with azure openai embeddings model - e.g. text-embedding-3-large"
+openai_embeddings_dimensions = "1536"
+openai_completions_deployment = "<replace with azure openai completions deployment name>"
+openai_completions_model = "<replace with azure openai completions model - e.g. gpt-35-turbo>"
+storage_file_url = "https://cosmosdbcosmicworks.blob.core.windows.net/fabcondata/movielens_dataset.json"
+```
+
 ```python
 # Import the required libraries
 import time

articles/cosmos-db/nosql/multi-tenancy-vector-search.md

@@ -16,11 +16,11 @@ ms.author: thvankra
 > "OpenAI relies on Cosmos DB to dynamically scale their ChatGPT service – one of the fastest-growing consumer apps ever – enabling high reliability and low maintenance." 
 > — Satya Nadella
 
-Azure Cosmos DB stands out as the world's first serverless vector search database, offering unparalleled scalability and performance. By using Azure Cosmos DB, users can enhance their vector search capabilities, ensuring high reliability and low maintenance for multitenant applications. 
+Azure Cosmos DB stands out as the world's first full-featured serverless operational database with vector search, offering unparalleled scalability and performance. By using Azure Cosmos DB, users can enhance their vector search capabilities, ensuring high reliability and low maintenance for multitenant applications. 
 
-Multi-tenancy enables a single instance of a database to serve multiple customers, or tenants, simultaneously. This approach efficiently shares infrastructure and operational overhead, resulting in cost savings and simplified management. It's a crucial design consideration for SaaS applications and some internal enterprise solutions.
+Multitenancy enables a single instance of a database to serve multiple customers, or tenants, simultaneously. This approach efficiently shares infrastructure and operational overhead, resulting in cost savings and simplified management. It's a crucial design consideration for SaaS applications and some internal enterprise solutions.
 
-Multi-tenancy introduces complexity. Your system must scale efficiently to maintain high performance across all tenants, who may have unique workloads, requirements, and service-level agreements (SLAs). 
+Multitenancy introduces complexity. Your system must scale efficiently to maintain high performance across all tenants, who may have unique workloads, requirements, and service-level agreements (SLAs). 
 
 Imagine a fictional AI-assisted research platform called ResearchHub. Serving thousands of companies and individual researchers, ResearchHub manages varying user bases, data scales, and SLAs. Ensuring low query latency and high performance is vital for sustaining an excellent user experience.
 
@@ -32,7 +32,7 @@ In Azure Cosmos DB, we recommend two primary approaches to managing multi-tenanc
 
 ### 1. Partition key-per-tenant
 
-For a higher density of tenants and lower isolation, the partition key-per-tenant model is effective. Each tenant is assigned a unique partition key within a given container, allowing logical separation of data. This strategy works best when each tenant has roughly the same workload volume. If there is significant skew, customers should consider isolating those tenants in their own account. Additionally, if a single tenant has more than 20GB of data, [hierarchical partition keys (HPK)](#hierarchical-partitioning-enhanced-data-organization) should be used.
+For a higher density of tenants and lower isolation, the partition key-per-tenant model is effective. Each tenant is assigned a unique partition key within a given container, allowing logical separation of data. This strategy works best when each tenant has roughly the same workload volume. If there is significant skew, customers should consider isolating those tenants in their own account. Additionally, if a single tenant has more than 20GB of data, [hierarchical partition keys (HPK)](#hierarchical-partitioning-enhanced-data-organization) should be used. For vector search in particular, quantizedFlat index may perform very well if vector search queries can be focused to a particular partition or sets of partitions.
 
 **Benefits:**
 - **Cost Efficiency:** Sharing a single Cosmos DB account across multiple tenants reduces overhead.
@@ -42,7 +42,7 @@ For a higher density of tenants and lower isolation, the partition key-per-tenan
 
 **Drawbacks:**
 - **Resource Contention:** Shared resources can lead to contention during peak usage.
-- **Limited Isolation:** Logical but not physical isolation, which may not meet stringent security needs.
+- **Limited Isolation:** Logical but not physical isolation, which may not meet strict isolation requirements.
 - **Less Flexibility:** Reduced flexibility per tenant for enabling account-level features like geo-replication, point-in-time restore (PITR), and customer-managed keys (CMK).
 
 ### Hierarchical partitioning: enhanced data organization
@@ -193,7 +193,7 @@ Azure Cosmos DB provides the tools necessary to build a robust, secure, and scal
 
 [30-day Free Trial without Azure subscription](https://azure.microsoft.com/try/cosmosdb/)
 
-[90-day Free Trial and up to $6,000 in throughput credits with Azure AI Advantage](../ai-advantage.md)
+[Multitenancy and Azure Cosmos DB](https://aka.ms/CosmosMultitenancy)
 
 > [!div class="nextstepaction"]
 > [Use the Azure Cosmos DB lifetime free tier](../free-tier.md)