Add core clr documentation

Author: pdelvo

StyleCopAnalyzers.sln

@@ -1,7 +1,7 @@
 
 Microsoft Visual Studio Solution File, Format Version 12.00
 # Visual Studio 14
-VisualStudioVersion = 14.0.23107.0
+VisualStudioVersion = 14.0.25123.0
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "StyleCop.Analyzers", "StyleCop.Analyzers\StyleCop.Analyzers\StyleCop.Analyzers.csproj", "{3B052737-06CE-4182-AE0F-08EB82DFA73E}"
 EndProject
@@ -35,6 +35,7 @@ EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "documentation", "documentation", "{19DD9E9D-877A-4492-9B7F-2E681DD58308}"
 	ProjectSection(SolutionItems) = preProject
 		documentation\Configuration.md = documentation\Configuration.md
+		documentation\DotNetCli.md = documentation\DotNetCli.md
 		documentation\EnableConfiguration.md = documentation\EnableConfiguration.md
 		documentation\KnownChanges.md = documentation\KnownChanges.md
 		documentation\SA0000Roslyn7446Workaround.md = documentation\SA0000Roslyn7446Workaround.md

documentation/DotNetCli.md

@@ -0,0 +1,34 @@
+
+# Using StyleCop Analyzers with dotnet cli
+
+StyleCop Analyzers can be used in dotnet cli projects, including asp.net core.
+The tooling support is currently not great and the analyzers only run when the project is compiled and there is currently no way to invoke the code fixes. What does work however is running Stylecop Analyzers in ubuntu on coreclr and OSX (probably) works too.
+To set this up a few steps are required:
+
+First the StyleCopAnalyzers nuget package has to be added to the project. Optimally the package should be marked as `build` type so it is not included as a package by other projects consuming it.
+For this add the following to the dependencies section of the project.json file:
+```json
+    "StyleCop.Analyzers": {
+      "version": "1.0.0",
+      "type": "build"
+    }
+```
+
+If the project is restored and built right now this will already run the analyzers. A few extra steps are needed if they should be configured.
+
+## Rulesets and stylecop.json
+
+To supply a ruleset file and a stylecop.json configuration file to the compiler they have to be manually added as arguments to the compiler. For this add the follwing under the `compilationOptions` node in the project.json file:
+```json
+    "additionalArguments": [ "/ruleset:path/to/ruleset.ruleset", "/additionalfile:path/to/stylecop.json" ]
+```
+
+## Enabling xml documentation processing
+
+All analyzers regarding xml documentation can only run if the xml processing is enabled. To do this add
+```json
+"xmlDoc": "true"
+```
+
+to the `compilationOptions` node of the project.json file. Note that this might cause additional CS1591 diagnostics to appear by the compiler.
+They can be suppressed in the ruleset file if necessary.