edits

Author: stevestein

docs/sql-operations-studio/TOC.md

@@ -6,10 +6,10 @@
 ## [Connect & query SQL Data Warehouse](quickstart-sql-dw.md)
 # Tutorials
 ## [T-SQL Editor](tutorial-sql-editor.md) 
-## [Enable the database performance insight](tutorial-qds-sql-server.md)
-## [Enable the table space usage insight](tutorial-table-space-sql-server.md)
-## [Build a custom insight to monitor active sessions](tutorial-build-custom-insight-sql-server.md) 
-## [Backup and restore](tutorial-backup-restore-sql-server.md)
+## [Monitor query performance](tutorial-qds-sql-server.md)
+## [Monitor table space usage](tutorial-table-space-sql-server.md)
+## [Build a custom monitoring insight](tutorial-build-custom-insight-sql-server.md) 
+## [Backup and restore databases](tutorial-backup-restore-sql-server.md)
 # How-to guides
 ## [Management dashboards & insight widgets](insight-widgets.md)
 ## [Code snippets](code-snippets.md)
@@ -22,5 +22,6 @@
 # Resources
 ## [Transact-SQL Reference](../t-sql/language-reference.md)
 ## [SQL Operations Studio (preview) GitHub repo](https://www.github.com/Microsoft/SqlOpsStudio)
+## [SQL Server Blog](https://blogs.technet.microsoft.com/dataplatforminsider/)
 # [FAQ](faq.md)
 # [Usage Data Collection](usage-data-collection.md)

docs/sql-operations-studio/download.md

@@ -21,30 +21,6 @@ ms.workload: "Inactive"
 > [!NOTE]
 > This preview version of [!INCLUDE[name-sos-short](../includes/name-sos-short.md)] installs by copying a zip (tar) file to your local computer, extracting (expanding) the file, and running the executable.
 
-## Supported Operating Systems
-
-[!INCLUDE[name-sos](../includes/name-sos-short.md)] runs on Windows, macOS, and Linux, and is supported on the following platforms:
-
-### Windows
-- Windows 10 (64-bit)
-- Windows 8.1 (64-bit)
-- Windows 8 (64-bit)
-- Windows 7 (SP1) (64-bit) - Requires [KB2533623](https://www.microsoft.com/en-us/download/details.aspx?id=26767)
-- Windows Server 2016
-- Windows Server 2012 R2 (64-bit)
-- Windows Server 2012 (64-bit)
-- Windows Server 2008 R2 (64-bit)
-
-### macOS
-- macOS 10.13 High Sierra
-- macOS 10.12 Sierra
-
-### Linux
-- Red Hat Enterprise Linux 7.4
-- Red Hat Enterprise Linux 7.3
-- SUSE Linux Enterprise Server v12 SP2
-- Ubuntu 16.04
-
 
 ## Get SQL Operations Studio (preview) for Windows
 
@@ -70,8 +46,9 @@ ms.workload: "Inactive"
 
 ## Get SQL Operations Studio (preview) for Linux
 
-1. Open a new Terminal window.
-2. Type the following commands to extract the file and launch [!INCLUDE[name-sos](../includes/name-sos-short.md)]:
+1. Download [[!INCLUDE[name-sos](../includes/name-sos-short.md)] for Linux](https://go.microsoft.com/fwlink/?linkid=XXXXX)
+2. Open a new Terminal window.
+3. Type the following commands to extract the file and launch [!INCLUDE[name-sos](../includes/name-sos-short.md)]:
 
    ```bash
    cd ~
@@ -82,11 +59,35 @@ ms.workload: "Inactive"
    sqlops .
    ```
 
-
 ## Uninstall SQL Operations Studio (preview)
 
 To uninstall [!INCLUDE[name-sos-short](../includes/name-sos-short.md)], delete the files.
 
+## Supported Operating Systems
+
+[!INCLUDE[name-sos](../includes/name-sos-short.md)] runs on Windows, macOS, and Linux, and is supported on the following platforms:
+
+### Windows
+- Windows 10 (64-bit)
+- Windows 8.1 (64-bit)
+- Windows 8 (64-bit)
+- Windows 7 (SP1) (64-bit) - Requires [KB2533623](https://www.microsoft.com/en-us/download/details.aspx?id=26767)
+- Windows Server 2016
+- Windows Server 2012 R2 (64-bit)
+- Windows Server 2012 (64-bit)
+- Windows Server 2008 R2 (64-bit)
+
+### macOS
+- macOS 10.13 High Sierra
+- macOS 10.12 Sierra
+
+### Linux
+- Red Hat Enterprise Linux 7.4
+- Red Hat Enterprise Linux 7.3
+- SUSE Linux Enterprise Server v12 SP2
+- Ubuntu 16.04
+
+
 ## Next Steps
 
 See one of the following quickstarts to get started:

docs/sql-operations-studio/faq.md

@@ -3,7 +3,7 @@ title: SQL Operations Studio (preview) FAQ | Microsoft Docs
 description: SQL Operations Studio (preview) is a lightweight, open source, multi-OS and multi-database tool, designed from the ground-up for DBAs and developers.
 keywords: 
 ms.custom: "tools|sos"
-ms.date: "11/08/2017"
+ms.date: "11/09/2017"
 ms.prod: "sql-non-specified"
 ms.reviewer: "alayu; erickang; sstein"
 ms.suite: "sql"
@@ -37,17 +37,21 @@ Anyone can use [!INCLUDE[name-sos](../includes/name-sos-short.md)]. However, it
 
 [!INCLUDE[name-sos](../includes/name-sos-short.md)] is built on top of Visual Studio Code and offers a lightweight, keyboard focused modern code workflow experience when working with SQL. 
 
-[!INCLUDE[name-sos](../includes/name-sos-short.md)] makes the core experiences that you rely on every day simple and easy with built-in features such as multiple tab windows, a rich SQL editor, IntelliSense, keyword completion, code snippets & code navigation and source control integration (Git and TFS). You can execute on demand queries, view & save results as text, JSON, or Excel, edit data, organize & manage your favorite database connections, and browse database objects in a familiar object browsing experience.
+[!INCLUDE[name-sos](../includes/name-sos-short.md)] makes the core experiences that you rely on every day simple and easy with built-in features such as multiple tab windows, a rich SQL editor, IntelliSense, keyword completion, code snippets & code navigation and source control integration (Git and TFS). You can execute on-demand queries, view & save results as text, JSON, or Excel, edit data, organize & manage your favorite database connections, and browse database objects in a familiar object browsing experience.
 
 Use your favorite command-line tools (for example, Bash, PowerShell, sqlcmd, bcp, psql, and ssh) in the Integrated Terminal window right within the [!INCLUDE[name-sos](../includes/name-sos-short.md)] user interface. Easily generate and execute CREATE and INSERT scripts for your database objects to create copies of your database for development or testing purposes. Boost your productivity with smart code snippets and rich graphical experiences that create new databases and database objects (such as tables, views, stored procedures, users, logins, roles, etc.) or update existing database objects. Use rich customizable dashboards to monitor and quickly troubleshoot performance bottlenecks in your databases on-premises, in Azure or any cloud.
 
-[!INCLUDE[name-sos](../includes/name-sos-short.md)] offers a consistent experience to backup and restore your databases. With planned support for SQL Server Always On Availability Groups, you can easily configure, monitor, and troubleshoot AGs for your mission-critical SQL Server databases and quickly failover to a secondary database in the event of a disaster.
-[!INCLUDE[name-sos](../includes/name-sos-short.md)] has been designed from the ground up to make you more productive in the DevOps lifecycle of your databases of choice on the operating systems of your choice. As a result, you are always in control, and you can reduce risks, solve problems faster, and continuously deliver value that exceeds customers’ expectations.
+[!INCLUDE[name-sos](../includes/name-sos-short.md)] offers a consistent experience to backup and restore your databases. With planned support for SQL Server Always On Availability Groups, you can easily configure, monitor, and troubleshoot AGs for your mission-critical SQL Server databases and quickly failover to a secondary database during a disaster.
+[!INCLUDE[name-sos](../includes/name-sos-short.md)] has been designed to make you more productive in the DevOps lifecycle of your databases of choice on the operating systems of your choice. As a result, you are always in control, and you can reduce risks, solve problems faster, and continuously deliver value that exceeds customers’ expectations.
 
 
 ## Is [!INCLUDE[name-sos](../includes/name-sos-short.md)] Open Source? 
 
-The source code for [!INCLUDE[name-sos](../includes/name-sos-short.md)] and its data providers is available on Github. The source code for the front end of [!INCLUDE[name-sos](../includes/name-sos-short.md)] (which is based on Visual Studio Code) is available under a source code EULA that provides rights to modify and use the software, but not to redistribute it or host it in a cloud service. The source code for the data providers is available under the MIT license.
+The source code for [!INCLUDE[name-sos](../includes/name-sos-short.md)] and its data providers is available on GitHub. The source code for the front end of [!INCLUDE[name-sos](../includes/name-sos-short.md)] (which is based on Visual Studio Code) is available under a source code EULA that provides rights to modify and use the software, but not to redistribute it or host it in a cloud service. The source code for the data providers is available under the MIT license at [https://github.com/Microsoft/sqltoolsservice](https://github.com/Microsoft/sqltoolsservice).
+
+## Do you plan to open source SSMS?
+
+No. However, next generation multi-OS CLI and GUI tools are open source. For example, the mssql extension for VS Code, mssql-scripter, and msql-CLI are all open source on GitHub. The source code for [!INCLUDE[name-sos](../includes/name-sos-short.md)] is available on GitHub.
 
 
 ## Now that there is [!INCLUDE[name-sos](../includes/name-sos-short.md)], does Microsoft plan to deprecate SSMS and SSDT?
@@ -56,27 +60,22 @@ No. Investments in flagship Windows tools (SSMS, SSDT, PowerShell) will continue
 The goal is to offer customers the choice of using the tools they want on the platforms of their choice for their scenarios.
 
 
-## Do you plan to open source SSMS?
-
-No. However, next generation multi-OS CLI and GUI tools are open source. For example, the mssql extension for VS Code, mssql-scripter are all open source on Github. The source code for [!INCLUDE[name-sos](../includes/name-sos-short.md)] is available on Github.
-
-
 ## [!INCLUDE[name-sos](../includes/name-sos-short.md)] is missing a feature that is in SSMS/SSDT. Will you add it?
-It depends on the scenario & customer/business need. To help prioritize, file a suggestion on Github: https://github.com/microsoft/sqlopsstudio/issues.
+It depends on the scenario & customer/business need. To help prioritize, file a suggestion on GitHub: https://github.com/microsoft/sqlopsstudio/issues.
 
 
-## I understand [!INCLUDE[name-sos](../includes/name-sos-short.md)] and the mssql extension for VS Code are powered by a new “tools service” that uses SMO APIs under the covers. Is SMO available on Linux and macOS?
+## I understand [!INCLUDE[name-sos](../includes/name-sos-short.md)] and the mssql extension for VS Code are powered by a new *tools service* that uses SMO APIs under the covers. Is SMO available on Linux and macOS?
 
-The SMO APIs are not yet available on Linux & macOS in a publicly consumable way. We ported over a subset of the SMO APIs to .NET Core that we needed for [!INCLUDE[name-sos](../includes/name-sos-short.md)], and we plan to expand as part of the roadmap.
-The SQL Tools Service is on Github: https://github.com/Microsoft/sqltoolsservice
+The SMO APIs are not yet available on Linux or macOS in a consumable way. We ported over a subset of the SMO APIs to .NET Core that we needed for [!INCLUDE[name-sos](../includes/name-sos-short.md)], and we plan to expand as part of the roadmap.
+The SQL Tools Service is on GitHub: [https://github.com/Microsoft/sqltoolsservice](https://github.com/Microsoft/sqltoolsservice).
 
 
-## I use SSDT and I am familiar with the DACFx APIs. Do you plan to port the DACFx APIs and/or sqlpackage.exe and/or SSDT to Linux and macOS?
+## Do you plan to port the DACFx APIs and/or sqlpackage.exe and/or SSDT to Linux and macOS?
 
-It's on the longer-term roadmap. To help prioritize, file a suggestion on Github: https://github.com/microsoft/sqlopsstudio/issues.
+It's on the longer-term roadmap. To help prioritize, file a suggestion on GitHub: [https://github.com/Microsoft/sqlopsstudio/issues](https://github.com/Microsoft/sqlopsstudio/issues).
 
 
 ## Will SQL PowerShell cmdlets be available on Linux and macOS?
 
-SQL PowerShell is available today on the PowerShell gallery and you can use it on Windows to work with SQL Server running anywhere, including SQL on Linux. Offering the SQL PowerShell cmdlets on Linux & macOS is in the roadmap. To help prioritize, file a suggestion on Github: https://github.com/microsoft/sqlopsstudio/issues.
+SQL PowerShell is available today on the PowerShell gallery and you can use it on Windows to work with SQL Server running anywhere, including SQL on Linux. Offering the SQL PowerShell cmdlets on Linux & macOS is in the roadmap. To help prioritize, file a suggestion on GitHub: [https://github.com/Microsoft/sqlopsstudio/issues](https://github.com/Microsoft/sqlopsstudio/issues).
 

docs/sql-operations-studio/keyboard-shortcuts.md

@@ -28,8 +28,6 @@ Open the **Keyboard Shortcuts** editor from the **File** menu: **File** > **Pref
 
 In addition to displaying current keybindings, the **Keyboard Shortcuts** editor lists the available commands that do not have keyboard shortcuts defined. The **Keyboard Shortcuts** editor enables you to easily change, remove, reset, and define new keybindings.  
 
-![keyboard Shortcuts editor](media/keyboard-shortcuts/keyboard-shortcuts.gif)
-
 
 ## Edit existing keyboard shortcuts
 

docs/sql-operations-studio/media/tutorial-qds-sql-server/sqlplan.png

@@ -29,7 +29,7 @@ As stated in the previous section, server group configuration details are stored
    ![Open user settings command](./media/server-groups/open-user-settings.png)
 
 1. In the right side list of settings, locate and copy the following two sections:
-   - datasource.connectionGropus
+   - datasource.connectionGroups
    - datasource.connections
 
    ![server groups in settings](./media/server-groups/server-groups-settings.png)
@@ -38,5 +38,5 @@ As stated in the previous section, server group configuration details are stored
 
 
 
-## Additiona resources
+## Additional resources
 - [Workspace and User settings](settings.md)

docs/sql-operations-studio/server-groups.md

@@ -27,11 +27,9 @@ In this tutorial, you learn how to use [!INCLUDE[name-sos](../includes/name-sos-
 
 ## Prerequisites
 
-This tutorial requires the SQL Server or Azure SQL Database *TutorialDB*. To create the *TutorialDB* database, complete one of the following quickstarts:
+This tutorial requires the SQL Server *TutorialDB*. To create the *TutorialDB* database, complete one of the following quickstarts:
 
 - [Connect and query SQL Server using [!INCLUDE[name-sos-short](../includes/name-sos-short.md)]](quickstart-sql-server.md)
-- [Connect and query Azure SQL Database using [!INCLUDE[name-sos-short](../includes/name-sos-short.md)]](quickstart-sql-database.md)
-
 
 
 ## Backup a database

docs/sql-operations-studio/tutorial-backup-restore-sql-server.md

@@ -85,7 +85,7 @@ To add an insight widget to your dashboard, edit the *dashboard.database.widgets
 
 4. Close the **Insights** pane.
 
-## View the query plan
+## View the query plan 
 
 1. Open a new query editor by pressing **Ctrl+N**.
 
@@ -99,12 +99,10 @@ To add an insight widget to your dashboard, edit the *dashboard.database.widgets
 
    ![showplan](./media/tutorial-qds-sql-server/showplan.png)
 
-## View the query plan in Query Data Store
-
-**??THIS OPENS AS TEXT FOR ME??**
-
-1. Open the insight detail dialog again.
+## Save and open a query plan 
 
+1. Open the insight detail dialog.
+2. Select one of the query items.
 2. Right-click **query_plan** value and select **Copy Cell**
 
    ![Insights QDS plan](./media/tutorial-qds-sql-server/insight-qds-plan.png)
@@ -113,11 +111,12 @@ To add an insight widget to your dashboard, edit the *dashboard.database.widgets
 
 4. Paste the copied plan into the editor.
 
-5. Press **Ctrl+S** to save the file, and change the file extension to *.showplan.
+5. Press **Ctrl+S** to save the file, and change the file extension to *.sqlplan*. For this tutorial, name the file *slowquery.sqlplan*.
+
+6. The query plan opens in [!INCLUDE[name-sos](../includes/name-sos-short.md)]'s query plan viewer:
 
-6. The query plan opens in [!INCLUDE[name-sos](../includes/name-sos-short.md)]'s query plan viewer.
+   ![Insights QDS plan](./media/tutorial-qds-sql-server/sqlplan.png)
 
-   >> ??TBD - screenshot??
 
 ## Next steps
 In this tutorial, you learned how to:

docs/sql-operations-studio/tutorial-qds-sql-server.md

@@ -3,7 +3,7 @@ title: "Tutorial: Enable the table space usage insight widget in SQL Operations
 description: This tutorial demonstrates how to enable the table space usage widget on the SQL Operations Studio (preview) database dashboard.
 keywords: 
 ms.custom: "tools|sos"
-ms.date: "11/08/2017"
+ms.date: "11/09/2017"
 ms.prod: "sql-non-specified"
 ms.reviewer: "alayu; erickang; sstein"
 ms.suite: "sql"
@@ -35,15 +35,15 @@ This tutorial requires the SQL Server or Azure SQL Database *TutorialDB*. To cre
 ## Turn on a management insight on [!INCLUDE[name-sos](../includes/name-sos-short.md)]'s database dashboard
 [!INCLUDE[name-sos](../includes/name-sos-short.md)] has a built-in sample widget to monitor the space used by tables in a database.
 
-1. Open **User Settings** by pressing **F1** to open *Command Palette*, type in *settings* in the command search input box and select **Preferences: Open User Settings**.
+1. Open **User Settings** by pressing **Ctrl+Shift+P** to open *Command Palette*, type *settings* in the search box and select **Preferences: Open User Settings**.
 
    ![Open user settings command](./media/tutorial-table-space-sql-server/open-user-settings.png)
 
 2. Type *dashboard* in Settings Search input box and locate **dashboard.database.widgets**.
 
    ![Search settings](./media/tutorial-table-space-sql-server/search-settings.png)
 
-3. Click **Copy to Settings** to customize **dashboard.database.widgets**.
+3. To customize the **dashboard.database.widgets** setting, hover over the pencil icon to the left of the **dashboard.database.widgets** text, click **Edit** > **Copy to Settings**.
 
 4. Using [!INCLUDE[name-sos](../includes/name-sos-short.md)]'s insight settings IntelliSense, configure *name* for the widget title, *gridItemConfig* for the widget size, and *widget* by selecting **table-space-db-insight** from the drop-down list as shown in the following screenshot: