arnaud articles

Author: Kat-Campise

articles/synapse-analytics/synapse-link/concept-synapse-link-cosmos-db-support.md

@@ -33,7 +33,7 @@ Here is list of the currently supported features within Synapse Link for Cosmos
 | **Read**    |Read data from an Azure Cosmos DB container| OLTP / HTAP | HTAP  |
 | **Write**   |Write data from run-time into an Azure Cosmos DB container| OLTP | n/a |
 
-* If you write data into an Azure Cosmos DB container from Spark happens through the transactional store of Azure Cosmos DB and will impact the transactional performance of Azure Cosmos DB by consuming Request Units.
+* If you write data into an Azure Cosmos DB container from Spark, this process happens through the transactional store of Azure Cosmos DB and will impact the transactional performance of Azure Cosmos DB by consuming Request Units.
 * SQL pool integration through external tables is currently not supported.
 
 ## Supported code-generated actions for Spark
@@ -51,7 +51,6 @@ Here is list of the currently supported features within Synapse Link for Cosmos
 ## Supported code-generated actions for SQL serverless
 
 | Gesture              | Description |OLTP |HTAP |
-=======
 | :-------------------- | :----------------------------------------------------------- |:----------------------------------------------------------- |:----------------------------------------------------------- |
 | **Select top 100** |Preview top 100 items from a container|X| ✓ |
 | **Create view** |Create a view to directly have BI access in a container through Synapse SQL|X| ✓ |

articles/synapse-analytics/synapse-link/how-to-connect-synapse-link-cosmos-db.md

@@ -17,7 +17,7 @@ This article describes how to access an Azure Cosmos DB database from Azure Syna
 
 ## Prerequisites
 
-Before you connect an Azure Cosmos DB account to your workspace, there are a few things that you need.
+Before you connect an Azure Cosmos DB account to your workspace, you'll need the following:
 
 * Existing Azure Cosmos DB account or create a new account following this [quickstart](https://docs.microsoft.com/azure/cosmos-db/how-to-manage-database-account)
 * Existing Synapse workspace or create a new workspace following this [quickstart](https://docs.microsoft.com/azure/synapse-analytics/quickstart-create-workspace) 

articles/synapse-analytics/synapse-link/how-to-query-analytical-store-spark.md

@@ -13,11 +13,13 @@ ms.reviewer: jrasnick
 
 # Query Cosmos DB analytical with Synapse Spark
 
-This article gives some examples on how you can interact with the analytical store from Synapse gestures. Those gestures are visible when you right-click on a container. With gestures, you can quickly generate code and tweak it to your needs. They are also perfect for discovering data with a single click.
+This article gives some examples on how you can interact with the analytical store from Synapse gestures. Gestures are visible when you right-click on a container. With gestures, you can quickly generate code and tailor it to your needs. They are also perfect for discovering data with a single click.
 
 ## Load to DataFrame
 
-In this step, you will read data from Azure Cosmos DB analytical store in a Spark DataFrame. It will display 10 rows from the DataFrame called ***df***. Once your data is into dataframe, you can perform additional analysis. This operation does not impact the transactional store.
+In this step, you will read data from Azure Cosmos DB analytical store in a Spark DataFrame. It will display 10 rows from the DataFrame called ***df***. Once your data is into dataframe, you can perform additional analysis. 
+
+This operation does not impact the transactional store.
 
 ```python
 # To select a preferred list of regions in a multi-region Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
@@ -32,7 +34,9 @@ df = spark.read.format("cosmos.olap")\
 
 ## Create Spark table
 
-In this gesture, you will create a Spark table pointing to the container you selected. That operation does not incur any data movement. If you decide to delete that table, the underlying container (and corresponding analytical store) won't be impacted. This scenario is convenient to reuse tables through third-party tools and provide accessibility to the data for the run-time.
+In this gesture, you will create a Spark table pointing to the container you selected. That operation does not incur any data movement. If you decide to delete that table, the underlying container (and corresponding analytical store) won't be impacted. 
+
+This scenario is convenient to reuse tables through third-party tools and provide accessibility to the data for the run-time.
 
 ```sql
 %%sql
@@ -45,7 +49,9 @@ create table call_center using cosmos.olap options (
 ```
 
 ## Write DataFrame to container
-In this gesture, you will write a dataframe into a container. This operation will impact the transactional performance and consume Request Units. Using Azure Cosmos DB transactional performance is ideal for write transactions. Make sure that you replace **YOURDATAFRAME** by the dataframe that you want to write back.
+In this gesture, you will write a dataframe into a container. This operation will impact the transactional performance and consume Request Units. Using Azure Cosmos DB transactional performance is ideal for write transactions. 
+
+Make sure that you replace **YOURDATAFRAME** by the dataframe that you want to write back.
 
 ```python
 # Write a Spark DataFrame into a Cosmos DB container
@@ -61,7 +67,9 @@ YOURDATAFRAME.write.format("cosmos.oltp")\
 ```
 
 ## Load streaming DataFrame from container
-In this gesture, you will use Spark Streaming capability to load data from a container into a dataframe. The data will be stored into the primary data lake account (and file system) that you connected to the workspace. If the folder /localReadCheckpointFolder is not created, it will be automatically created. This operation will impact the transactional performance of Cosmos DB.
+In this gesture, you will use Spark Streaming capability to load data from a container into a dataframe. The data will be stored into the primary data lake account (and file system) that you connected to the workspace. 
+
+If the folder */localReadCheckpointFolder* is not created, it will be automatically created. This operation will impact the transactional performance of Cosmos DB.
 
 ```python
 # To select a preferred list of regions in a multi-region Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
@@ -78,7 +86,7 @@ dfStream = spark.readStream\
 ```
 
 ## Write streaming DataFrame to container
-In this gesture, you will write a streaming dataframe into the Cosmos DB container you selected. If the folder /localReadCheckpointFolder is not created, it will be automatically created. This operation will impact the transactional performance of Cosmos DB.
+In this gesture, you will write a streaming dataframe into the Cosmos DB container you selected. If the folder */localReadCheckpointFolder* is not created, it will be automatically created. This operation will impact the transactional performance of Cosmos DB.
 
 ```python
 # To select a preferred list of regions in a multi-region Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
@@ -94,4 +102,9 @@ streamQuery = dfStream\
         .start()
 
 streamQuery.awaitTermination()
-```
+```
+
+## Next steps
+
+* [Learn what is supported between Synapse and Azure Cosmos DB](./concept-synapse-link-cosmos-db-support.md)
+* [Connect to Synapse Link for Cosmos DB](../quickstart-connect-synapse-link-cosmos-db.md)