Merge pull request #228874 from seesharprun/cosmos-update-overviews

v-dirichards · web-flow · commit 58453d125532 · 2023-02-28T10:28:49.000-06:00
Cosmos DB | Refresh introduction articles per latest linter standards
diff --git a/articles/cosmos-db/cassandra/introduction.md b/articles/cosmos-db/cassandra/introduction.md
@@ -1,5 +1,5 @@
 ---
-title: Introduction
+title: Introduction/Overview
 titleSuffix: Azure Cosmos DB for Apache Cassandra
 description: Use Azure Cosmos DB for Apache Cassandra to power existing and new applications with Cassandra drivers and CQL.
 author: TheovanKraay
@@ -8,11 +8,11 @@ ms.reviewer: mjbrown
 ms.service: cosmos-db
 ms.subservice: apache-cassandra
 ms.topic: overview
-ms.date: 11/30/2022
+ms.date: 02/28/2023
 ms.custom: ignite-2022
 ---
 
-# Introduction to Azure Cosmos DB for Apache Cassandra
+# What is Azure Cosmos DB for Apache Cassandra?
 
 [!INCLUDE[Cassandra](../includes/appliesto-cassandra.md)]
 
@@ -47,17 +47,6 @@ The API for Cassandra has added benefits of being built on Azure Cosmos DB:
 
 ## Next steps
 
-> [!div class="nextstepaction"]
-> [Get started with our Python Quickstart](manage-data-python.md)
-
-Want to learn more?
-
-- You can quickly get started with building the following language-specific apps to create and manage API for Cassandra data:
-  - [Node.js app](manage-data-nodejs.md)
-  - [.NET app](manage-data-dotnet.md)
-  - [Python app](manage-data-python.md)
 - Get started with [creating a API for Cassandra account, database, and a table](create-account-java.md) by using a Java application.
 - [Load sample data to the API for Cassandra table](load-data-table.md) by using a Java application.
 - [Query data from the API for Cassandra account](query-data.md) by using a Java application.
-- To learn about Apache Cassandra features supported by Azure Cosmos DB for Apache Cassandra, see [Cassandra support](support.md) article.
-- Read the [Frequently Asked Questions](cassandra-faq.yml).
diff --git a/articles/cosmos-db/gremlin/introduction.md b/articles/cosmos-db/gremlin/introduction.md
@@ -1,17 +1,17 @@
 ---
-title: Introduction
+title: Introduction/Overview
 titleSuffix: Azure Cosmos DB for Apache Gremlin
 description: Use Azure Cosmos DB for Apache Gremlin to store, query, and traverse massive graphs with the Gremlin graph query language of Apache TinkerPop.
 author: manishmsfte
 ms.author: mansha
 ms.service: cosmos-db
 ms.subservice: apache-gremlin
 ms.topic: overview
-ms.date: 11/30/2022
+ms.date: 02/28/2023
 ms.custom: ignite-2022
 ---
 
-# Introduction to Azure Cosmos DB for Apache Gremlin
+# What is Azure Cosmos DB for Apache Gremlin?
 
 [!INCLUDE[Gremlin](../includes/appliesto-gremlin.md)]
 
@@ -31,7 +31,7 @@ The API for Gremlin combines the power of graph database algorithms with highly
 
 The API for Gremlin has added benefits of being built on Azure Cosmos DB:
 
-- **Elastically scalable throughput and storage**: Graphs in the real world need to scale beyond the capacity of a single server. Azure Cosmos DB supports horizontally scalable graph databases that can have an unlimited size in terms of storage and provisioned throughput. As the graph database scale grows, the data will be automatically distributed using [graph partitioning](./partitioning.md).
+- **Elastically scalable throughput and storage**: Graphs in the real world need to scale beyond the capacity of a single server. Azure Cosmos DB supports horizontally scalable graph databases that can have an unlimited size in terms of storage and provisioned throughput. As the graph database scale grows, the data is automatically distributed using [graph partitioning](./partitioning.md).
 
 - **Multi-region replication**: Azure Cosmos DB can automatically replicate your graph data to any Azure region worldwide. Global replication simplifies the development of applications that require global access to data. In addition to minimizing read and write latency anywhere around the world, Azure Cosmos DB provides automatic regional failover mechanism. This mechanism can ensure the continuity of your application in the rare case of a service interruption in a region.
 
@@ -65,7 +65,7 @@ A graph database approach relies on persisting relationships in the storage laye
 
 ### Property graph objects
 
-A property [graph](http://mathworld.wolfram.com/Graph.html) is a structure that's composed of [vertices](http://mathworld.wolfram.com/GraphVertex.html) and [edges](http://mathworld.wolfram.com/GraphEdge.html). Both objects can have an arbitrary number of key-value pairs as properties.
+A property [graph](https://mathworld.wolfram.com/Graph.html) is a structure that's composed of [vertices](https://mathworld.wolfram.com/GraphVertex.html) and [edges](https://mathworld.wolfram.com/GraphEdge.html). Both objects can have an arbitrary number of key-value pairs as properties.
 
 - **Vertices/nodes**: Vertices denote discrete entities, such as a person, place, or an event.
 
@@ -93,7 +93,7 @@ This graph has the following *vertex* types. These types are also called *labels
 
 - **Operating Systems**: The operating systems that the devices run on.
 
-- **Place**: The places from which the devices are accessed.
+- **Place**: The place\[s\] where devices are accessed.
 
 We represent the relationships between these entities via the following *edge* types:
 
@@ -153,10 +153,6 @@ g.V('thomas.1').
 
 ## Next steps
 
-> [!div class="nextstepaction"]
-> [Get started with our Java Quickstart](quickstart-java.md)
-
-Want to learn more?
-
 - Get started with the [API for Graph .NET quickstart](quickstart-dotnet.md).
 - Learn how to [query graphs in API for Graph using Gremlin](tutorial-query.md).
+- Learn about [graph data modeling](modeling.md).
diff --git a/articles/cosmos-db/mongodb/introduction.md b/articles/cosmos-db/mongodb/introduction.md
@@ -1,17 +1,17 @@
 ---
-title: Introduction
+title: Introduction/Overview
 titleSuffix: Azure Cosmos DB for MongoDB
 description: Use Azure Cosmos DB for MongoDB to store and query massive amounts of data using popular open-source drivers.
 author: gahl-levy
 ms.author: gahllevy
 ms.service: cosmos-db
 ms.subservice: mongodb
 ms.topic: overview
-ms.date: 01/18/2023
+ms.date: 02/28/2023
 ms.custom: ignite-2022
 ---
 
-# Introduction to Azure Cosmos DB for MongoDB
+# What is Azure Cosmos DB for MongoDB?
 
 [!INCLUDE[MongoDB](../includes/appliesto-mongodb.md)]
 
@@ -38,7 +38,7 @@ The API for MongoDB has added benefits of being built on Azure Cosmos DB when co
 
 - **Serverless deployments**: Unlike MongoDB Atlas, the API for MongoDB is a cloud native database that offers a [serverless capacity mode](../serverless.md). With [Serverless](../serverless.md), you're only charged per operation, and don't pay for the database when you don't use it.
 
-- **Free Tier**: With Azure Cosmos DB free tier, you'll get the first 1000 RU/s and 25 GB of storage in your account for free forever, applied at the account level.
+- **Free Tier**: With Azure Cosmos DB free tier, you get the first 1000 RU/s and 25 GB of storage in your account for free forever, applied at the account level.
 
 - **Upgrades take seconds**: All API versions are contained within one codebase, making version changes as simple as [flipping a switch](upgrade-version.md), with zero downtime.
 
@@ -81,18 +81,6 @@ All the APIs for MongoDB versions run on the same codebase, making upgrades a si
 
 ## Next steps
 
-> [!div class="nextstepaction"]
-> [Get started with our Node.js Quickstart](quickstart-nodejs.md)
-
-Want to learn more?
-
-- Trying to do capacity planning for a migration to Azure Cosmos DB? You can use information about your existing database cluster for capacity planning.
-  - If all you know is the number of vCores and servers in your existing database cluster, read about [estimating request units using vCores or vCPUs](../convert-vcore-to-request-unit.md).
-  - If you know typical request rates for your current database workload, read about [estimating request units using Azure Cosmos DB capacity planner](estimate-ru-capacity-planner.md).
 - Follow the [Connect a MongoDB application to Azure Cosmos DB](connect-account.md) tutorial to learn how to get your account connection string information.
 - Follow the [Use Studio 3T with Azure Cosmos DB](connect-using-mongochef.md) tutorial to learn how to create a connection between your Azure Cosmos DB database and MongoDB app in Studio 3T.
 - Follow the [Import MongoDB data into Azure Cosmos DB](../../dms/tutorial-mongodb-cosmos-db.md?toc=%2fazure%2fcosmos-db%2ftoc.json%253ftoc%253d%2fazure%2fcosmos-db%2ftoc.json) tutorial to import your data to an Azure Cosmos DB database.
-- Connect to an Azure Cosmos DB account using [Robo 3T](connect-using-robomongo.md).
-- Learn how to [Configure read preferences for globally distributed apps](tutorial-global-distribution.md).
-- Find the solutions to commonly found errors in our [Troubleshooting guide](error-codes-solutions.md)
-- Configure near real time analytics with [Azure Synapse Link for Azure Cosmos DB](../configure-synapse-link.md)
diff --git a/articles/cosmos-db/postgresql/introduction.md b/articles/cosmos-db/postgresql/introduction.md
@@ -1,19 +1,18 @@
 ---
-title: Overview of Azure Cosmos DB for PostgreSQL
-description: Read an overview guide for running Azure Cosmos DB for PostgreSQL.
-ms.author: jonels
+title: Introduction/Overview
+titleSuffix: Azure Cosmos DB for PostgreSQL
+description: Use Azure Cosmos DB for PostgreSQL to run your PostgreSQL relational data workloads at any scale using your existing skills.
 author: jonels-msft
-ms.custom: mvc, ignite-2022
+ms.author: jonels
 ms.service: cosmos-db
 ms.subservice: postgresql
 ms.topic: overview
+ms.date: 02/28/2023
+ms.custom: mvc, ignite-2022
 recommendations: false
-ms.date: 09/29/2022
 ---
-<!-- markdownlint-disable MD033 -->
-<!-- markdownlint-disable MD026 -->
 
-# Azure Cosmos DB for PostgreSQL
+# What is Azure Cosmos DB for PostgreSQL?
 
 [!INCLUDE [PostgreSQL](../includes/appliesto-postgresql.md)]
 
@@ -28,7 +27,7 @@ distributing your tables.
 Real-world customer applications built on Azure Cosmos DB for PostgreSQL include software-as-a-service (SaaS) apps, real-time
 operational analytics apps, and high throughput transactional apps. These apps
 span various verticals such as sales and marketing automation, healthcare,
-Internet of Things (IoT) telemetry, finance, logistics, and search.
+Internet of Things (IoT) data, finance, logistics, and search.
 
 :::image type="content" source="media/overview/distributed.png" alt-text="Diagram that shows distributed architecture." border="false":::
 
@@ -37,34 +36,30 @@ Internet of Things (IoT) telemetry, finance, logistics, and search.
 As you're looking to create applications with Azure Cosmos DB for PostgreSQL, ensure you've
 reviewed the following articles:
 
-<!-- markdownlint-disable MD032 -->
-
 > [!div class="checklist"]
+>
 > - Learn how to [build scalable apps](quickstart-build-scalable-apps-overview.md).
 > - Connect and query with your [app stack](quickstart-app-stacks-overview.yml).
-> - See how the [Azure Cosmos DB for PostgreSQL API](reference-overview.md) extends
->   PostgreSQL, and try [useful diagnostic
->   queries](howto-useful-diagnostic-queries.md).
+> - See how the [Azure Cosmos DB for PostgreSQL API](reference-overview.md) extends PostgreSQL, and try [useful diagnostic queries](howto-useful-diagnostic-queries.md).
 > - Pick the best [cluster size](howto-scale-initial.md) for your workload.
 > - [Monitor](howto-monitoring.md) cluster performance.
 > - Ingest data efficiently with [Azure Stream Analytics](howto-ingest-azure-stream-analytics.md)
 >   and [Azure Data Factory](howto-ingest-azure-data-factory.md).
-
-<!-- markdownlint-enable MD032 -->
+>
 
 ## Fully managed, resilient database
 
 As Azure Cosmos DB for PostgreSQL is a fully managed service, it has all the features for
 worry-free operation in production. Features include:
 
-* automatic high availability
-* backups
-* built-in pgBouncer
-* read-replicas
-* easy monitoring
-* private endpoints
-* encryption
-* and more
+- automatic high availability
+- backups
+- built-in pgBouncer
+- read-replicas
+- easy monitoring
+- private endpoints
+- encryption
+- and more
 
 > [!div class="nextstepaction"]
 > [Try the quickstart >](quickstart-create-portal.md)
@@ -91,5 +86,6 @@ application requires greater scale, you can add nodes and rebalance your data.
 
 ## Next steps
 
-> [!div class="nextstepaction"]
-> [Try the quickstart >](quickstart-create-portal.md)
+- [Create a new account](quickstart-create-portal.md) using the Azure portal.
+- [Connect to a cluster](quickstart-connect-psql.md) with psql.
+- Use the Citus extension to [distribute tables](quickstart-distribute-tables.md).
diff --git a/articles/cosmos-db/table/introduction.md b/articles/cosmos-db/table/introduction.md
@@ -1,17 +1,17 @@
 ---
-title: Introduction
+title: Introduction/Overview
 titleSuffix: Azure Cosmos DB for Table
-description: Use Azure Cosmos DB for Table to store and query massive volumes of key-value data.
+description: Use Azure Cosmos DB for Table to store, manage, and query massive volumes of key-value typed NoSQL data.
 author: seesharprun
 ms.author: sidandrews
 ms.service: cosmos-db
 ms.subservice: table
 ms.topic: overview
-ms.date: 11/30/2022
+ms.date: 02/28/2023
 ms.custom: ignite-2022
 ---
 
-# Introduction to Azure Cosmos DB for Table
+# What is Azure Cosmos DB for Table?
 
 [!INCLUDE[Table](../includes/appliesto-table.md)]
 
@@ -39,7 +39,7 @@ If you currently use Azure Table Storage, you gain the following benefits by mov
 | | Azure Table storage | API for Table |
 | --- | --- | --- |
 | **Latency** | Fast, but no upper bounds on latency. | Single-digit millisecond latency for reads and writes, backed with <10-ms latency for reads and writes at the 99th percentile, at any scale, anywhere in the world. |
-| **Throughput** | Variable throughput model. Tables have a scalability limit of 20,000 operations/s. | Highly scalable with [dedicated reserved throughput per table](../request-units.md) that's backed by SLAs. Accounts have no upper limit on throughput and support >10 million operations/s per table. |
+| **Throughput** | Variable throughput model. Tables have a scalability limit of 20,000 operations/s. | Highly scalable with [dedicated reserved throughput per table](../request-units.md) backed by SLAs. Accounts have no upper limit on throughput and support >10 million operations/s per table. |
 | **Global distribution** | Single region with one optional readable secondary read region for high availability. | [Turnkey global distribution](../distribute-data-globally.md) from one to any number of regions. Support for [service-managed and manual failovers](../high-availability.md) at any time, anywhere in the world. Multiple write regions to let any region accept write operations. |
 | **Indexing** | Only primary index on PartitionKey and RowKey. No secondary indexes. | Automatic and complete indexing on all properties by default, with no index management. |
 | **Query** | Query execution uses index for primary key, and scans otherwise. | Queries can take advantage of automatic indexing on properties for fast query times. |
@@ -49,14 +49,6 @@ If you currently use Azure Table Storage, you gain the following benefits by mov
 
 ## Next steps
 
-> [!div class="nextstepaction"]
-> [Get started with our .NET Quickstart](quickstart-dotnet.md)
-
-Want to learn more?
-
 - [Query table data by using the API for Table](tutorial-query.md)
 - [Learn how to set up Azure Cosmos DB global distribution by using the API for Table](tutorial-global-distribution.md)
 - [Azure Cosmos DB Table .NET SDK](/dotnet/api/overview/azure/data.tables-readme)
-- [Azure Cosmos DB Table Java SDK](/java/api/overview/azure/data-tables-readme)
-- [Azure Cosmos DB Table Node.js SDK](/javascript/api/overview/azure/data-tables-readme)
-- [Azure Cosmos DB Table SDK for Python](/python/api/azure-data-tables/azure.data.tables)
