Merge pull request #61 from rothja/getstartedwork

Outline of getting started guide

Author: rothja

docs/linux/sql-server-linux-get-started-tutorial.md

@@ -6,7 +6,7 @@ description:
 author: rothja 
 ms.author: jroth 
 manager: jhubbard
-ms.date: 10-20-2016
+ms.date: 10-26-2016
 ms.topic: article
 ms.prod: sql-non-specified
 ms.service: 
@@ -27,5 +27,46 @@ ms.assetid:
 ---
 # Get started with SQL Server on Linux
 
+This topic is a guide for how to get started using SQL Server vNext CTP1 on Linux. It does not assume that you have experience with either Linux or SQL Server. If you do have a background in either area, you can scan this topic to find any additional information or links to other resources.
+
+## Install Linux
+If you do not already have a Linux machine, you must either install Linux on a physical server or a virtual machine (VM).
+
+### Manual installation
+To manually install Linux on a target machine, review the documentation provided for your target platform:
+
+- [Ubuntu 16.04](https://www.ubuntu.com/download)
+- [Red Hat Enterprise Linux 7.2](https://www.redhat.com/en/technologies/linux-platforms/enterprise-linux)
+- [Docker Engine 1.8+](http://www.docker.com/products/docker#/linux)
+
 > [!NOTE]
-> This tutorial was meant to walk people through an end-to-end experience. But it might get repetitive with the breakout topics for install and connect and query. So instead it might provide a walk through that points to those other sections like a learning map. In this case it might act more as a top-level orientation topic in this section of content.
+> Although the focus of this topic is on installing SQL Server vNext on Linux, you can also install it on the latest [Docker for Mac](http://www.docker.com/products/docker#/mac) and [Docker for Windows](http://www.docker.com/products/docker#/windows). 
+
+### Azure VMs
+Another option is to install Linux on a virtual machine. Use the following topics to create virtual machines in Azure with Linux already installed. 
+
+- [Ubuntu 16.04 Azure VM](https://azure.microsoft.com/marketplace/partners/canonical/ubuntuserver1604lts/)
+- [Red Hat Enterprise Linux 7.2 Azure VM](https://azure.microsoft.com/marketplace/partners/redhat/redhatenterpriselinux72/)
+
+For a tutorial that walks you through the VM creation process, see [Create a Linux VM on Azure using the Portal](https://azure.microsoft.com/documentation/articles/virtual-machines-linux-quick-create-portal/). For all other Azure Linux VM resources, see [Linux Virtual Machines documentation](https://azure.microsoft.com/documentation/services/virtual-machines/linux/).
+
+## Install SQL Server
+Next, set up SQL Server vNext on your Linux machine using one of the following guides:
+
+| Distribution | Installation |
+|-----|-----|
+| Ubuntu | [Installation guide](sql-server-linux-setup-ubuntu.md) |
+| Red Hat Enterprise | [Installation guide](sql-server-linux-setup-red-hat.md) |
+| Docker | [Installation guide](sql-server-linux-setup-docker.md) |
+
+## Connect locally or remotely
+TODO: provide links to the connection topics and talk about local and remote connectivity
+
+## Create a database
+TODO: provide the T-SQL for creating a database. Point to restore article that installs the AdventureWorks sample DB.
+
+## Explore SQL Server capabilities on Linux
+TODO: provide links to the main SQL Server documentation, maybe a table of the most popular ones with links and descriptions. Link to supportability topic here too for guidance on understanding how to read the main documentation set in relation to SQL Server.
+
+## Next Steps
+TODO: point to other topics in this content set.

docs/linux/sql-server-linux-overview.md

@@ -27,27 +27,23 @@ ms.assetid:
 ---
 # SQL Server on Linux overview
 
-This topic provides and overview of SQL Server vNext CTP1 running on Linux. 
+SQL Server vNext CTP1 now runs on Linux. The topics in this section focuses on what you need to know to use SQL Server on Linux. In many ways, SQL Server capabilities and features work the same regardless of your operating system. The content in this section highlights Linux-specific guidance. 
 
-In many areas, SQL Server capabilities and features operate the same regardless of the operating system. The content in this section highlights Linux-specific guidance. 
-
-## Supported features
-For specific information about what this release supports on Linux, see [Supported features of SQL Server on Linux](sql-server-linux-supported-features.md). For known issues, also review the [Release notes](sql-server-linux-release-notes.md).
-
-## Installation
+## Supported distributions
 
 The following Linux distributions are currently supported for this release.
 
-| Distribution | Installation |
-|-----|-----|
-| Ubuntu 16.04 | [Installation guide](sql-server-linux-setup-ubuntu.md) |
-| Red Hat Enterprise Linux 7.2 | [Installation guide](sql-server-linux-setup-red-hat.md) |
-| Docker Engine 1.8+ | [Installation guide](sql-server-linux-setup-docker.md) |
+- **Ubuntu 16.04**
+- **Red Hat Enterprise Linux 7.2**
+- **Docker Engine 1.8+, Docker for Mac/Windows**
+
+## Supported features
+For specific information about what this release supports on Linux, see [Supported features of SQL Server on Linux](sql-server-linux-supported-features.md). For known issues, also review the [Release notes](sql-server-linux-release-notes.md).
 
-## Next steps
+## Get started
 
-Once you've installed SQL Server vNext, there are several ways to get started.
+Use the following resources to get started using SQL Server on Linux:
 
 - Go through the topics in the [Get started](sql-server-linux-get-started-tutorial.md) section.
 - [Install the AdventureWorks sample database](sql-server-linux-restore-database.md).
-- Review the complete set of [SQL Server documentation](https://msdn.microsoft.com/library/mt590198.aspx). The documentation applies to SQL Server running on any platform (except for areas that are not yet [supported on Linux](sql-server-linux-supported-features.md)).
+- Review the complete set of [SQL Server documentation](https://msdn.microsoft.com/library/mt590198.aspx). This content applies to SQL Server running on any platform (except for areas that are not yet [supported on Linux](sql-server-linux-supported-features.md)).

docs/linux/sql-server-linux-setup.md

@@ -29,7 +29,7 @@ ms.assetid:
 
 SQL Server vNext CTP1 is supported on several distribution of Linux. It is also available as a Docker image which can run on Docker for Linux, Windows, and Mac. The topics in this section provide tutorials and general guidance for installing SQL Server vNext CTP1 on Linux. 
 
-## Supported distirbutions
+## Supported distributions
 SQL Server vNext CTP1 is supported on the following distributions:
 
 | Distribution | Supported version |
@@ -47,7 +47,7 @@ It also has support for the Docker Engine running on any supported Linux distrib
 
 ## Installation guides
 
-The following guides provide installation walkthroughs for the supported Linux distributions.
+The following guides provide step-by-step installation guides for the supported Linux distributions.
 
 - [Install SQL Server on Linux (Ubuntu)](sql-server-linux-setup-ubuntu.md)
 - [Install SQL Server on Linux (Red Hat Enterprise Linux)](sql-server-linux-setup-red-hat.md)