Merge pull request #3212 from gewarren/package-mapping

Roslyn package mapping reference

Author: ktoliver

docs/extensibility/getting-started-with-roslyn-analyzers.md

@@ -31,5 +31,6 @@ With live, project-based code analyzers in Visual Studio, API authors can ship d
 ## See also
 
 - [Roslyn analyzers overview](../code-quality/roslyn-analyzers-overview.md)
+- [.NET compiler platform package version reference](roslyn-version-support.md)
 - [More docs on the GitHub OSS site](https://github.com/dotnet/roslyn/tree/master/docs/analyzers)
 - [FxCop rules implemented with Roslyn analyzers on GitHub](https://github.com/dotnet/roslyn/tree/master/src/Diagnostics/FxCop)

docs/extensibility/roslyn-version-support.md

@@ -0,0 +1,37 @@
+---
+title: Supported Roslyn package version mappings
+ms.date: 11/02/2018
+ms.technology: vs-ide-sdk
+ms.topic: reference
+helpviewer_keywords: 
+  - roslyn package versions
+author: gewarren
+ms.author: gewarren
+manager: douge
+ms.workload: 
+  - "vssdk"
+---
+# .NET compiler platform package version reference
+
+The following table shows which [.NET compiler platform (Roslyn) package](https://www.nuget.org/packages/Microsoft.Net.Compilers/) versions are supported for different versions of Visual Studio 2015 and Visual Studio 2017. To ensure that your custom analyzer works on all versions of Visual Studio 2017, for example, it should target version 2.0 of Microsoft.Net.Compilers.
+
+| Roslyn package version | Supported Visual Studio version |
+| - | - |
+| 1.0.1 | Visual Studio 2015 RTM or higher |
+| 1.1.1 | Visual Studio 2015 update 1 or higher |
+| 1.2.2 | Visual Studio 2015 update 2 or higher |
+| 1.3.2 | Visual Studio 2015 update 3 or higher |
+| 2.0.0 | Visual Studio 2017 RTM or higher |
+| 2.1.0 | Visual Studio 2017 version 15.1 or higher |
+| 2.2.0 | Visual Studio 2017 version 15.2 or higher |
+| 2.3.2 | Visual Studio 2017 version 15.3 or higher |
+| 2.4.0 | Visual Studio 2017 version 15.4 or higher |
+| 2.6.1 | Visual Studio 2017 version 15.5 or higher |
+| 2.7.0 | Visual Studio 2017 version 15.6 or higher |
+| 2.8.2 | Visual Studio 2017 version 15.7 or higher |
+| 2.9.0 | Visual Studio 2017 version 15.8 or higher |
+
+## See also
+
+- [.NET Compiler Platform SDK](/dotnet/csharp/roslyn-sdk/)
+- [Get started with Roslyn analyzers](getting-started-with-roslyn-analyzers.md)

docs/extensibility/toc.yml

@@ -740,3 +740,5 @@
     href: getting-started-with-roslyn-analyzers.md
   - name: Roslyn Analyzers and Code-aware Library for ImmutableArrays
     href: roslyn-analyzers-and-code-aware-library-for-immutablearrays.md
+  - name: Roslyn package version reference
+    href: roslyn-version-support.md