Acrolinx updates

Author: whhender

articles/synapse-analytics/get-started-add-admin.md

@@ -13,13 +13,13 @@ ms.custom: subject-rbac-steps
 
 # Add an administrator to your Synapse workspace
 
-In this tutorial, you'll learn how to add an administrator to your Synapse workspace. This user will have full control over the workspace.
+In this tutorial, you'll learn how to add an administrator to your Synapse workspace. This user has full control over the workspace.
 
 ## Overview
 
-So far in the get started guide, we've focused on activities *you* do in the workspace. Because you created the workspace in STEP 1, you are an administrator of the Synapse workspace. Now, we will make another user Ryan (`[email protected]`) an administrator. When we are done, Ryan will be able to do everything you can do in the workspace.
+So far in the get started guide, we've focused on activities *you* do in the workspace. Because you created the workspace in STEP 1, you're an administrator of the Synapse workspace. Now, we'll make another user Ryan (`[email protected]`) an administrator. When we're done, Ryan will be able to do everything you can do in the workspace.
 
-## Azure RBAC: Owner role for the workspace
+## Azure role-based access control: Owner role for the workspace
 
 1. Open the Azure portal and open your Synapse workspace.
 1. On the left side, select **Access control (IAM)**.
@@ -36,10 +36,9 @@ So far in the get started guide, we've focused on activities *you* do in the wor
 
 1. Select **Save**. 
 
- 
-## Synapse RBAC: Synapse Administrator role for the workspace
+## Synapse role-based access control: Synapse Administrator role for the workspace
 
-Assign to `[email protected]` to Synapse RBAC **Synapse Administrator** role on the workspace.
+Assign to `[email protected]` to the **Synapse Administrator** role on the workspace.
 
 1. Open your workspace in Synapse Studio.
 1. On the left side, select  **Manage** to open the Manage hub.
@@ -49,7 +48,7 @@ Assign to `[email protected]` to Synapse RBAC **Synapse Administrator** role on t
 1. Add `[email protected]` to the **Synapse Administrator** role. 
 1. Then select **Apply**.
 
-## Azure RBAC: Role assignments on the workspace's primary storage account
+## Azure role-based access control: Role assignments on the workspace's primary storage account
 
 1. Open the workspace's primary storage account in the Azure portal.
 1. On the left side, select **Access control (IAM)**.

articles/synapse-analytics/get-started-analyze-storage.md

@@ -35,12 +35,12 @@ df.write.mode("overwrite").parquet("/NYCTaxi/PassengerCountStats_parquetformat")
 
 ### Analyze data in a storage account
 
-You can analyze the data in your workspace default ADLS Gen2 account or you can link an ADLS Gen2 or Blob storage account to your workspace through "**Manage**" > "**Linked Services**" > "**New**" (The steps below will refer to the primary ADLS Gen2 account).
+You can analyze the data in your workspace default Azure Data Lake Storage (ADLS) Gen2 account or you can link an ADLS Gen2 or Blob storage account to your workspace through "**Manage**" > "**Linked Services**" > "**New**" (The next steps will refer to the primary ADLS Gen2 account).
 
 1. In Synapse Studio, go to the **Data** hub, and then select **Linked**.
 1. Go to **Azure Data Lake Storage Gen2** > **myworkspace (Primary - contosolake)**.
 1. Select **users (Primary)**. You should see the **NYCTaxi** folder. Inside you should see two folders called **PassengerCountStats_csvformat** and **PassengerCountStats_parquetformat**.
-1. Open the **PassengerCountStats_parquetformat** folder. Inside, you'll see a parquet file with a name like `part-00000-2638e00c-0790-496b-a523-578da9a15019-c000.snappy.parquet`.
+1. Open the **PassengerCountStats_parquetformat** folder. Inside, there's a parquet file with a name like `part-00000-2638e00c-0790-496b-a523-578da9a15019-c000.snappy.parquet`.
 1. Right-click **.parquet**, then select **New notebook**, then select **Load to DataFrame**. A new notebook is created with a cell like this:
 
     ```py
@@ -50,7 +50,7 @@ You can analyze the data in your workspace default ADLS Gen2 account or you can
     display(df.limit(10))
     ```
 
-1. Attach to the Spark pool named **Spark1**. Run the cell. If you run into an error related to lack of cores, this spark pool may be used by another session. Cancel all the existing sessions and retry.
+1. Attach to the Spark pool named **Spark1**. Run the cell. If you run into an error related to lack of cores, another session could be using this spark pool this spark pool. Cancel all the existing sessions and retry.
 1. Select back to the **users** folder. Right-click the **.parquet** file again, and then select **New SQL script** > **SELECT TOP 100 rows**. It creates a SQL script like this:
 
     ```sql

articles/synapse-analytics/get-started-create-workspace.md

@@ -16,7 +16,7 @@ In this tutorial, you'll learn how to create a Synapse workspace, a dedicated SQ
 
 ## Prerequisites
 
-To complete this tutorial's steps, you need to have access to a resource group for which you are assigned the **Owner** role. Create the Synapse workspace in this resource group.
+To complete this tutorial's steps, you need to have access to a resource group for which you're assigned the **Owner** role. Create the Synapse workspace in this resource group.
 
 ## Create a Synapse workspace in the Azure portal
 
@@ -36,7 +36,7 @@ Fill in the following fields:
 Fill in the following fields:
 
 1. **Workspace name** - Pick any globally unique name. In this tutorial, we'll use **myworkspace**.
-1. **Region** - Pick the region where you have placed your client applications/services (for example, Azure VM, Power BI, Azure Analysis Service) and storages that contain data (for example Azure Data Lake storage, Azure Cosmos DB analytical storage).
+1. **Region** - Pick the region where you have placed your client applications/services (for example, Azure Virtual Machine, Power BI, Azure Analysis Service) and storages that contain data (for example Azure Data Lake storage, Azure Cosmos DB analytical storage).
 
 > [!NOTE]
 > A workspace that is not co-located with the client applications or storage can be the root cause of many performance issues. If your data or the clients are placed in multiple regions, you can create separate workspaces in different regions co-located with your data and clients.
@@ -66,17 +66,17 @@ After your Azure Synapse workspace is created, you have two ways to open Synapse
 > To sign into your workspace, there are two **Account selection methods**. One is from **Azure subscription**, the other is from **Enter manually**. If you have the Synapse Azure role or higher level Azure roles, you can use both methods to log into the workspace. If you don't have the related Azure roles, and you were granted as the Synapse RBAC role, **Enter manually** is the only way to log into the workspace. To learn more about the Synapse RBAC, refer to [What is Synapse role-based access control (RBAC)](./security/synapse-workspace-synapse-rbac.md).
 
 ## Place sample data into the primary storage account
-We are going to use a small 100K row sample dataset of NYC Taxi Cab data for many examples in this getting started guide. We begin by placing it in the primary storage account you created for the workspace.
+We're going to use a small 100 K row sample dataset of NYC Taxi Cab data for many examples in this getting started guide. We begin by placing it in the primary storage account you created for the workspace.
 
-* Download the [NYC Taxi - green trip dataset](../open-datasets/dataset-taxi-green.md?tabs=azureml-opendatasets#additional-information) to your computer. Navigate to the [original dataset location](https://www.nyc.gov/site/tlc/about/tlc-trip-record-data.page) from the above link, choose a specific year and download the Green taxi trip records in Parquet format.
+* Download the [NYC Taxi - green trip dataset](../open-datasets/dataset-taxi-green.md?tabs=azureml-opendatasets#additional-information) to your computer. Navigate to the [original dataset location](https://www.nyc.gov/site/tlc/about/tlc-trip-record-data.page) from the link, choose a specific year and download the Green taxi trip records in Parquet format.
 * Rename the downloaded file to *NYCTripSmall.parquet*.
 * In Synapse Studio, navigate to the **Data** Hub.
 * Select **Linked**.
-* Under the category **Azure Data Lake Storage Gen2** you'll see an item with a name like **myworkspace ( Primary - contosolake )**.
+* Under the category Azure Data Lake Storage Gen2,** you'll see an item with a name like **myworkspace ( Primary - contosolake )**.
 * Select the container named **users (Primary)**.
 * Select **Upload** and select the `NYCTripSmall.parquet` file you downloaded.
 
-Once the parquet file is uploaded it is available through two equivalent URIs:
+Once the parquet file is uploaded, it's available through two equivalent URIs:
 * `https://contosolake.dfs.core.windows.net/users/NYCTripSmall.parquet` 
 * `abfss://[email protected]/NYCTripSmall.parquet`
 

articles/synapse-analytics/get-started-knowledge-center.md

@@ -18,14 +18,14 @@ In this tutorial, you'll learn how to use the Synapse Studio **Knowledge center*
 
 There are two ways of finding the **Knowledge center** in Synapse Studio:
 
-  1. In the Home hub, near the top-right of the page click on **Learn**.
-  2. In the menu bar at the top, click **?** and then **Knowledge center**.
+  1. In the Home hub, near the top-right of the page, select **Learn**.
+  2. In the menu bar at the top, select **?** and then **Knowledge center**.
 
 Pick either method and open the **Knowledge center**.
 
 ## Exploring the Knowledge center
 
-Once it is visible, you will see that the **Knowledge center** allows you to do three things:
+Once it's visible, you'll see that the **Knowledge center** allows you to do three things:
 * **Use samples immediately**. If you want a quick example of how Synapse works, choose this option.
 * **Browse gallery**. This option lets you link sample data sets and add sample code in the form of SQL scripts, notebooks, and pipelines.
 * **Tour Synapse Studio**. This option takes you on a brief tour of the basic parts of Synapse Studio. This is useful if you have never used Synapse Studio before.
@@ -37,23 +37,23 @@ There are three items in this section:
 * Query data with SQL
 * Create external table with SQL
 
-1. In the **Knowledge center**, click **Use samples immediately**.
+1. In the **Knowledge center**, select **Use samples immediately**.
 1. Select **Query data with SQL**.
-1. Click **Use sample**.
+1. Select **Use sample**.
 1. A new sample SQL script will open.
 1. Scroll to the first query (lines 28 to 32) and select the query text.
-1. Click Run. It will run only code you have selected.
+1. select Run. It will run only code you have selected.
 
 ## Gallery: A collection of sample datasets and sample code
 
-1. Go to the **Knowledge center**, click **Browse gallery**.
+1. Go to the **Knowledge center**, select **Browse gallery**.
 1. Select the **SQL scripts** tab at the top.
-1. Select **Load the New York Taxicab dataset** Data ingestion sample, click **Continue**.
+1. Select **Load the New York Taxicab dataset** Data ingestion sample, select **Continue**.
 1. Under **SQL pool**, choose **Select an existing pool** and select **SQLPOOL1**, and select the **SQLPOOL1** database you created earlier.
-1. Click **Open Script**.
+1. Select **Open Script**.
 1. A new sample SQL script will open.
-1. Click **Run**
-1. This will create several tables for all of the NYC Taxi data and load them using the T-SQL COPY command. If you had created these tables in the previous quick start steps, select and execute only code to CREATE and COPY for tables that do not exist.
+1. Select **Run**
+1. This will create several tables for all of the NYC Taxi data and load them using the T-SQL COPY command. If you had created these tables in the previous quick start steps, select and execute only code to CREATE and COPY for tables that don't exist.
 
     > [!NOTE] 
     > When using the sample gallery for SQL script with a dedicated SQL pool (formerly SQL DW), you will only be able to use an existing dedicated SQL pool (formerly SQL DW).