dotnet sln (dotnet#1519)

* init

* dotnet sln init

* adressing comments

* adressing comments

* spelling

* change format to git style

* spacing

* addressing feedback

* added missing header

Author: spboyer

docs/core/preview3/tools/dotnet-sln.md

@@ -0,0 +1,83 @@
+---
+title: dotnet-sln command | Microsoft Docs
+description: The dotnet-sln command provides a convenient option to add, remove, and list projects in a solution file.
+keywords: dotnet-run, CLI, CLI command, .NET Core
+author: spboyer
+ms.author: mairaw
+ms.date: 02/06/2017
+ms.topic: article
+ms.prod: .net-core
+ms.technology: dotnet-cli
+ms.devlang: dotnet
+ms.assetid: e5a72d3e-c14b-4b0a-a978-c5e54a0988c6
+---
+# dotnet-sln
+
+[!INCLUDE[preview-warning](../../../includes/warning.md)]
+
+## Name
+
+`dotnet-sln` - Modifies a .NET Core solution file.
+
+## Synopsis
+
+```
+dotnet sln [<SLN_NAME>] add <project> <project>
+dotnet sln [<SLN_NAME>] add **/**
+dotnet sln [<SLN_NAME>] remove <project> <project>
+dotnet sln [<SLN_NAME>] remove **/**
+dotnet sln [<SLN_NAME>] list
+dotnet sln [-h|--help]
+```
+
+## Description
+
+The `dotnet sln` command provides a convenient way to add, remove and list projects in a solution file.
+
+## Commands
+
+`add <project>`
+
+`add **/*`
+
+Adds a project or multiple projects to the solution file. Glob pattern is supported on Unix/Linux based terminals.
+
+`remove <project>`
+
+`remove **/*`
+
+Remove a project or multiple projects from the solution file. Glob pattern is supported on Unix/Linux based terminals.
+
+`list`
+
+List all projects in a solution file.
+
+## Arguments
+
+`SLN_NAME`
+
+Solution file to use. If not specified, the command will search the current directory for one. If there are multiple solution files in the directory; one must be specified.
+
+## Options
+
+`-h|--help`
+
+Prints out a short help for the command.
+
+## Examples
+
+Add a project to a solution:
+
+`dotnet sln todo.sln add todo-app/todo-app.csproj`
+
+Add a project to the solution in the current directory:
+
+`dotnet sln add todo-app.csproj`
+
+Remove a project from a solution:
+
+`dotnet sln todo.sln remove todo-app/todo-app.csproj`
+
+Add multiple projects to a solution using globbing pattern:
+
+`dotnet sln add **/**/*.fsproj`