diff --git a/DevelopmentWorkflow.md b/DevelopmentWorkflow.md
new file mode 100644
index 000000000..2db846a35
--- /dev/null
+++ b/DevelopmentWorkflow.md
@@ -0,0 +1,59 @@
+Development Workflow
+====================
+
+## Full build
+This will create all deliverables from the NativeScript repo in the `bin/dist/*.tgz` folder:
+```
+npm install
+grunt
+```
+
+## Using tns-core-modules from source in app
+This will register the location of the `tns-core-modules` sources as symlink in your npm:
+```
+cd tns-core-modules
+npm link
+```
+
+To rebuild the JavaScript of the `tns-core-modules`, in the root of the NativeScript repo:
+```
+# this will update tns-core-modules.d.ts references with new .d.ts files
+grunt generate-tns-core-modules-dev-dts
+# this will rebuild the TS to JS
+tsc
+```
+
+Then you can navigate to any NativeScript App and add the `tns-core-modules` from the NativeScript repo to the `node_modules/tns-core-modules` in the app with:
+```
+npm link tns-core-modules
+```
+You should be able to debug the App in VSCode, breakpoints in the `node_modules/tns-core-modules` TypeScript files should work.
+Changes in the App's `node_modules/tns-core-modules` will edit the files in the NativeScript repo so you should be able to easily add changes to git.
+
+## Running mobile unit tests
+There is `tests` folder with regular NativeScript application that runs tests on the `tns-core-modules`.
+To run them (see Using tns-core-modules from source in app):
+```
+npm install
+grunt generate-tns-core-modules-dev-dts
+tsc
+
+cd tns-core-modules
+npm link
+cd ..
+
+cd tests
+npm link tns-core-modules
+cd ..
+
+tns run [ios|android] --path tests
+```
+
+You can rapidly apply canges to the `tns-core-modules` and `tests`, and to run the tests, at the root of the NativeScript repo, execute:
+```
+# optionally, if you have added new .d.ts files
+grunt generate-tns-core-modules-dev-dts
+
+tsc
+tns run [ios|android] --path tests
+```
diff --git a/tsconfig.json b/tsconfig.json
index 1c1d66c41..855051379 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -9,7 +9,7 @@
         "noImplicitAny": false,
         "noImplicitUseStrict": true,
         "experimentalDecorators": true,
-        "diagnostics": false
+        "diagnostics": true
     },
     "filesGlob": [
         "**/*.ts",