updates for reviewer comments

Author: julieMSFT

articles/synapse-analytics/spark/synapse-spark-sql-pool-import-export.md

@@ -175,7 +175,7 @@ To alter missing permissions for others, you need to be the Storage Blob Data Ow
 | Access Permissions | --X | --X | --X | --X | --X | --X | -WX |
 | Default Permissions | ---| ---| ---| ---| ---| ---| ---|
 
-- You should be able to ACL all folders from "synapse" and downward from Azure Portal. In order to ACL the root "/" folder, please follow the instructions below.
+- You should be able to ACL all folders from "synapse" and downward from Azure portal. In order to ACL the root "/" folder, please follow the instructions below.
 
 - Please connect to the storage account connected with the workspace from Storage Explorer using AAD
 - Select your Account and give the ADLS Gen2 URL and default file system for the workspace
@@ -186,5 +186,5 @@ To alter missing permissions for others, you need to be the Storage Blob Data Ow
 
 ## Next steps
 
-- [Create a SQL pool]([Create a new Apache Spark pool for an Azure Synapse Analytics workspace](../../synapse-analytics/quickstart-create-apache-spark-pool.md))
+- [Create a SQL pool](../../synapse-analytics/quickstart-create-apache-spark-pool.md))
 - [Create a new Apache Spark pool for an Azure Synapse Analytics workspace](../../synapse-analytics/quickstart-create-apache-spark-pool.md) 

articles/synapse-analytics/sql/create-use-external-tables.md

@@ -22,31 +22,35 @@ In this section, you'll learn how to create and use external tables in SQL on-de
 Your first step is to create a database where the tables will be created. Then initialize the objects by executing [setup script](https://github.com/Azure-Samples/Synapse/blob/master/SQL/Samples/LdwSample/SampleDB.sql) on that database. This setup script will create the following objects that are used in this sample:
 - DATABASE SCOPED CREDENTIAL `sqlondemand` that enables access to SAS-protected `https://sqlondemandstorage.blob.core.windows.net` Azure storage account.
 
-```sql
-CREATE DATABASE SCOPED CREDENTIAL [sqlondemand]
-WITH IDENTITY='SHARED ACCESS SIGNATURE',  
-SECRET = 'sv=2018-03-28&ss=bf&srt=sco&sp=rl&st=2019-10-14T12%3A10%3A25Z&se=2061-12-31T12%3A10%3A00Z&sig=KlSU2ullCscyTS0An0nozEpo4tO5JAgGBvw%2FJX2lguw%3D'
-```
+    ```sql
+    CREATE DATABASE SCOPED CREDENTIAL [sqlondemand]
+    WITH IDENTITY='SHARED ACCESS SIGNATURE',  
+    SECRET = 'sv=2018-03-28&ss=bf&srt=sco&sp=rl&st=2019-10-14T12%3A10%3A25Z&se=2061-12-31T12%3A10%3A00Z&sig=KlSU2ullCscyTS0An0nozEpo4tO5JAgGBvw%2FJX2lguw%3D'
+    ```
+
 - EXTERNAL DATA SOURCE `sqlondemanddemo` that references demo storage account protected with SAS key, and EXTERNAL DATA SOURCE `YellowTaxi` that references publicly available Azure storage account on location `https://azureopendatastorage.blob.core.windows.net/nyctlc/yellow/`.
-```sql
-CREATE EXTERNAL DATA SOURCE SqlOnDemandDemo WITH (
-    LOCATION = 'https://sqlondemandstorage.blob.core.windows.net',
-    CREDENTIAL = sqlondemand
-);
-GO
-CREATE EXTERNAL DATA SOURCE YellowTaxi
-WITH ( LOCATION = 'https://azureopendatastorage.blob.core.windows.net/nyctlc/yellow/')
-```
+
+    ```sql
+    CREATE EXTERNAL DATA SOURCE SqlOnDemandDemo WITH (
+        LOCATION = 'https://sqlondemandstorage.blob.core.windows.net',
+        CREDENTIAL = sqlondemand
+    );
+    GO
+    CREATE EXTERNAL DATA SOURCE YellowTaxi
+    WITH ( LOCATION = 'https://azureopendatastorage.blob.core.windows.net/nyctlc/yellow/')
+    ```
+
 - File formats `QuotedCSVWithHeaderFormat` and `ParquetFormat` that describe CSV and parquet file types.
-```sql
-CREATE EXTERNAL FILE FORMAT QuotedCsvWithHeaderFormat
-WITH (  
-    FORMAT_TYPE = DELIMITEDTEXT,
-    FORMAT_OPTIONS ( FIELD_TERMINATOR = ',', STRING_DELIMITER = '"', FIRST_ROW = 2   )
-);
-GO
-CREATE EXTERNAL FILE FORMAT ParquetFormat WITH (  FORMAT_TYPE = PARQUET );
-```
+
+    ```sql
+    CREATE EXTERNAL FILE FORMAT QuotedCsvWithHeaderFormat
+    WITH (  
+        FORMAT_TYPE = DELIMITEDTEXT,
+        FORMAT_OPTIONS ( FIELD_TERMINATOR = ',', STRING_DELIMITER = '"', FIRST_ROW = 2   )
+    );
+    GO
+    CREATE EXTERNAL FILE FORMAT ParquetFormat WITH (  FORMAT_TYPE = PARQUET );
+    ```
 
 The queries in this article will be executed on your sample database and use these objects. 
 

articles/synapse-analytics/sql/develop-openrowset.md

@@ -23,27 +23,27 @@ OPENROWSET function in Synapse SQL reads the content of the file(s) from a data
 The `OPENROWSET` function can optionally contain a `DATA_SOURCE` parameter to specify the data source that contains files.
 - `OPENROWSET` without `DATA_SOURCE` can be used to directly read the contents of the files from the URL location specified as `BULK` option:
 
-```sql
-SELECT *
-FROM OPENROWSET(BULK 'http://storage..../container/folder/*.parquet',
-                TYPE = 'PARQUET') AS file
-```
+    ```sql
+    SELECT *
+    FROM OPENROWSET(BULK 'http://storage..../container/folder/*.parquet',
+                    TYPE = 'PARQUET') AS file
+    ```
 
 This is a quick and easy way to read the content of the files without pre-configuration. This option enables you to use the basic authentication option to access the storage (Azure AD passthrough for Azure AD logins and SAS token for SQL logins). 
 
 - `OPENROWSET` with `DATA_SOURCE` can be used to access files on specified storage account:
 
-```sql
-SELECT *
-FROM OPENROWSET(BULK '/folder/*.parquet',
-                DATA_SOURCE='storage', --> Root URL is in LOCATION of DATA SOURCE
-                TYPE = 'PARQUET') AS file
-```
-
-This option enables you to configure location of the storage account in the data source and specify the authentication method that should be used to access storage. 
+    ```sql
+    SELECT *
+    FROM OPENROWSET(BULK '/folder/*.parquet',
+                    DATA_SOURCE='storage', --> Root URL is in LOCATION of DATA SOURCE
+                    TYPE = 'PARQUET') AS file
+    ```
 
-> [!IMPORTANT]
-> `OPENROWSET` without `DATA_SOURCE` provides quick and easy way to access the storage files but offers limited authentication options. As an example, Azure AD principal can access files only using their [Azure AD identity](develop-storage-files-storage-access-control.md#user-identity) and cannot access publicly available files. If you need more powerful authentication options, use `DATA_SOURCE` option and define credential that you want to use to access storage.
+    This option enables you to configure location of the storage account in the data source and specify the authentication method that should be used to access storage. 
+    
+    > [!IMPORTANT]
+    > `OPENROWSET` without `DATA_SOURCE` provides quick and easy way to access the storage files but offers limited authentication options. As an example, Azure AD principal can access files only using their [Azure AD identity](develop-storage-files-storage-access-control.md#user-identity) and cannot access publicly available files. If you need more powerful authentication options, use `DATA_SOURCE` option and define credential that you want to use to access storage.
 
 ## Security
 
@@ -135,8 +135,10 @@ The WITH clause allows you to specify columns that you want to read from files.
 
 - For CSV data files, to read all the columns, provide column names and their data types. If you want a subset of columns, use ordinal numbers to pick the columns from the originating data files by ordinal. Columns will be bound by the ordinal designation. 
 
-> [!IMPORTANT]
-> The WITH clause is mandatory for CSV files.
+    > [!IMPORTANT]
+    > The WITH clause is mandatory for CSV files.
+    >
+    
 - For Parquet data files, provide column names that match the column names in the originating data files. Columns will be bound by name. If the WITH clause is omitted, all columns from Parquet files will be returned.
 
 column_name = Name for the output column. If provided, this name overrides the column name in the source file.