chore: fixup readme

README.md

@@ -1,8 +1,8 @@
-<img src="https://raw.githubusercontent.com/nstudio/nativescript/master/tools/graphics/nativescript-v8-logo-cropped.png?token=AADPTY7GXDQOQZXOMXRAWIC6YGI4A" width="100" />
+# NativeScript [![Build Status](https://travis-ci.org/NativeScript/NativeScript.svg?branch=master)](https://travis-ci.org/NativeScript/NativeScript)
 
-# NativeScript
+![NativeScript logo](https://i.imgur.com/YmNIMqS.png)
 
-TypeScript driven development for native platform api's.
+[NativeScript](http://www.nativescript.org) empowers you to access native api's from JavaScript directly. The framework currently provides iOS and Android runtimes for rich mobile development and can be utilized in a number of diverse use cases.
 
 # Develop
 
@@ -15,18 +15,57 @@ $ npm start
 
 # Packages
 
-* [@nativescript/core]()
+* [@nativescript/core](https://www.npmjs.com/package/@nativescript/core)
   * Core iOS/Android for NativeScript
-  * [How to contribute]()
-* [@nativescript/types]()
+* [@nativescript/types](https://www.npmjs.com/package/@nativescript/types)
   * Types for both iOS/Android below wrapped up as a convenience. *Most commonly used.*
-* [@nativescript/types-ios]()
+* @nativescript/types-ios
   * Types for iOS
-* [@nativescript/types-android]()
+* @nativescript/types-android
   * Types for Android
-* [@nativescript/ui-mobile-base]()
+* @nativescript/ui-mobile-base
   * UI mobile base native classes used by core
-  * [How to contribute]()
-* [@nativescript/webpack]()
+* [@nativescript/webpack](https://www.npmjs.com/package/@nativescript/webpack)
   * Webpack build utilities and configs used by NativeScript apps
-  * [How to contribute]()
+
+## Getting Started and Installation
+
+Our Getting Started Guides are hands-on tutorials that walk you through installing NativeScript and building a real iOS and Android application.
+
+* [Get started with JavaScript](http://docs.nativescript.org/tutorial/chapter-0)
+* [Get started with TypeScript and Angular](http://docs.nativescript.org/angular/tutorial/ng-chapter-0)
+
+## Quick Links
+
+- [NativeScript home page](https://nativescript.org)
+- [Install NativeScript demo mobile app](https://www.nativescript.org/nativescript-example-application)
+- [NativeScript playground](https://play.nativescript.org)
+- [NativeScript and Angular](https://play.nativescript.org/?template=play-ng&tutorial=getting-started-ng)
+- [@NativeScript on Twitter](http://twitter.com/NativeScript)
+- [NativeScript community Slack channel](https://www.nativescript.org/slack-invitation-form)
+- [NativeScript on Stack Overflow](http://stackoverflow.com/questions/tagged/nativescript)
+- [NativeScript documentation](https://docs.nativescript.org/)
+- [NativeScript marketplace](https://market.nativescript.org/)
+- [NativeScript roadmap](https://www.nativescript.org/roadmap)
+
+## Repositories
+
+Outside of the source centralized in this repo, the NativeScript framework consists of a number of components, all of which are open source and on GitHub. Here are the major ones:
+
+- **[iOS runtime](https://github.com/NativeScript/ns-v8ios-runtime)**
+    [![npm](https://img.shields.io/npm/dm/tns-ios.svg)](https://www.npmjs.com/package/@nativescript/ios) 
+    - This repo contains the NativeScript iOS runtime — the code that hosts NativeScript iOS apps, and allows JavaScript code to be executed on iOS devices. The iOS runtime is written in a fun mix of C++, Objective-C, and more.
+- **[Android runtime](//github.com/NativeScript/android-runtime)**
+    [![npm](https://img.shields.io/npm/dm/tns-android.svg)](https://www.npmjs.com/package/tns-android) 
+    - This repo contains the NativeScript Android — the code that hosts NativeScript Android apps, and allows JavaScript code to be executed on Android devices. The Android runtime is written in a fun mix of C++ and Java.
+- **[CLI](//github.com/NativeScript/nativescript-cli)**
+    [![npm](https://img.shields.io/npm/dm/nativescript.svg)](https://www.npmjs.com/package/nativescript) 
+    - This repo contains the NativeScript command-line interface, which lets you create, build, and run apps using the NativeScript framework. The CLI is written in TypeScript.
+- **[Docs](//github.com/NativeScript/docs)** [![Docs](https://img.shields.io/badge/Docs-NativeScript-brightgreen)](https://docs.nativescript.org/)
+    - This repo contains the NativeScript framework documentation, which is available at <http://docs.nativescript.org/>. The docs are written in Markdown.
+
+In addition to the code that makes up the NativeScript framework itself, we also provide a number of [open-source sample apps](https://www.nativescript.org/app-samples-with-code) that you can reference while building your NativeScript application.
+
+## Contributing
+
+We love PRs, and accept them for all of our repositories — even docs! Please follow our [contribution guide](https://github.com/NativeScript/NativeScript/blob/master/tools/notes/CONTRIBUTING.md) if you want to become part of the project.

tools/notes/CONTRIBUTING.md

@@ -52,8 +52,9 @@ git remote add upstream https://github.com/NativeScript/NativeScript.git
 
 ```bash
 #In the repo root
-npm install
 npm run setup
+#View interactive options
+npm start
 ```
 
 3. Create a branch for your PR
@@ -159,7 +160,7 @@ Must be one of the following:
 The scope should be the name of the affected component in the code.
 If the change affects only one of the target platforms (android, ios) that should be specified in the scope.
 
-Sample scopes for the `tns-core-modules` package:
+Sample scopes for the `@nativescript/core` package:
 
 * **android/application**
 * **ios/application**