added documentation for disabling TypeScript Build in VS

Author: nycdotnet

README.md

@@ -327,6 +327,8 @@ grunt.initConfig({
 });
 ````
 
+If you wish to disable the Visual Studio built-in TypeScript build, but keep the Visual Studio project properties TypeScript Build pane working, follow [these instructions](./docs/DisableVisualStudioBuild.md).
+
 
 #### watch
 

custom.TypeScript.targets

@@ -0,0 +1,13 @@
+<Project DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <PropertyGroup>
+    <CfgPropertyPagesGuidsAddCSharp>{d4683cae-88c4-4b85-863d-ac8014f3ba36}</CfgPropertyPagesGuidsAddCSharp>
+    <CfgPropertyPagesGuidsAddVB>{d4683cae-88c4-4b85-863d-ac8014f3ba36}</CfgPropertyPagesGuidsAddVB>
+    <CfgPropertyPagesGuidsAddTypeScript>{d4683cae-88c4-4b85-863d-ac8014f3ba36}</CfgPropertyPagesGuidsAddTypeScript>
+  </PropertyGroup>
+  <ItemGroup>
+    <ProjectCapability Include="TypeScript" />
+  </ItemGroup>
+  <PropertyGroup>
+    <TypeScriptEnabled>true</TypeScriptEnabled>
+  </PropertyGroup>
+</Project>

docs/DisableVisualStudioBuild.md

@@ -0,0 +1,34 @@
+# How to disable the Visual Studio TypeScript Build
+*but keep the TypeScript Project Properties Pane Working...*
+
+If you are using Visual Studio and wish to compile your TypeScript with grunt-ts *only*, you can disable the Visual Studio TypeScript build by performing the following steps:
+
+  * First, make sure your project has TypeScript support enabled by opening the project properties and confirming that the TypeScript Build properties pane is selectable.
+  * Next, make sure your project folder has grunt-ts installed, and confirm that running grunt with the appropriate configuration will compile your project correctly.
+  * Exit Visual Studio (Targets are only read once, so unloading the project is not sufficient).
+  * Make sure that your project is backed-up or fully checked-in to Source Control.
+  * Edit the .csproj or .vbproj file for which you wish to disable VS TypeScript building.
+  * Search for the line containing the text "Microsoft.TypeScript.targets".  Delete or comment-out the entire line.
+  * At that spot, add one of these lines:
+
+**If grunt-ts is installed in node_modules under the Project folder:**
+```xml
+<Import Project="$(ProjectDir)\node_modules\grunt-ts\custom.TypeScript.targets" Condition="Exists('$(ProjectDir)\node_modules\grunt-ts\custom.TypeScript.targets')" />
+```
+
+**If grunt-ts is installed in node_modules under the Solution folder:**
+```xml
+<Import Project="$(SolutionDir)\node_modules\grunt-ts\custom.TypeScript.targets" Condition="Exists('$(SolutionDir)\node_modules\grunt-ts\custom.TypeScript.targets')" />
+```
+
+**If grunt-ts is installed elsewhere**
+Modify one of the previous examples to point to the `custom.TypeScript.targets` file.
+
+  * If you have multiple projects in your solution, you must edit each .csproj or .vbproj.
+  * Reload Visual Studio and confirm that the TypeScript Build pane still appears in the project properties.
+  * Then, introduce an error in a TypeScript file such as a mismatched parenthesis.
+  * Finally, press Ctrl+Shift+B to initiate a build.  If the build succeeds, you've successfully disabled the TypeScript compilation in Visual Studio.  Run Grunt to build your project and it should fail.  Fix the error and Grunt should then succeed (assuming it was prior to you making these changes).
+  
+  
+  
+  

grunt-ts.csproj

@@ -90,9 +90,12 @@
     <Content Include="tsd.json" />
     <Content Include="tslint.json" />
   </ItemGroup>
-  <ItemGroup />
+  <ItemGroup>
+    <Content Include="docs\DisableVisualStudioBuild.md" />
+  </ItemGroup>
   <PropertyGroup Condition="'$(Configuration)' == 'Debug'">
     <TypeScriptTarget>ES3</TypeScriptTarget>
   </PropertyGroup>
-  <Import Project="$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v$(VisualStudioVersion)\TypeScript\Microsoft.TypeScript.targets" Condition="Exists('$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v$(VisualStudioVersion)\TypeScript\Microsoft.TypeScript.targets')" />
+  <!-- <Import Project="$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v$(VisualStudioVersion)\TypeScript\Microsoft.TypeScript.targets" Condition="Exists('$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v$(VisualStudioVersion)\TypeScript\Microsoft.TypeScript.targets')" /> -->
+  <Import Project="$(ProjectDir)\custom.TypeScript.targets" Condition="Exists('$(ProjectDir)\custom.TypeScript.targets')" />
 </Project>