Merge branch 'ErjanGavalji/apply-important-master-PRs' into production

Author: ErjanGavalji

application-management.md

@@ -17,9 +17,9 @@ The `application` module lets you manage the life cycle of your NativeScript app
 
 ## Start Application
 
-You must call the **start** method of the application module after the module initialization. 
+This method is required only for iOS applications. 
 
-This method is required for iOS applications. 
+> **IMPORTANT:** You must call the `start` method of the application module **after** the module initialization. Any code after the `start` call will not be executed.
 
 ### Example
 

navigation.md

@@ -18,7 +18,7 @@ NativeScript apps consist of pages which represent the separate application scre
 * [Navigation](#navigation)
     * [The Topmost Frame](#the-topmost-frame)
     * [Navigate by Page Name](#navigate-by-page-name)
-    * [Navigate with Factory Function](#navigate-with-factory-function)
+    * [Navigate Using a Function](#navigate-using-a-function)
     * [Navigate and Pass Context](#navigate-and-pass-context)
     * [Navigate without History](#navigate-without-history)
     * [Navigate Back](#navigate-back)
@@ -123,11 +123,11 @@ To navigate between pages, you can use the [`navigate`](ApiReference/ui/frame/RE
 
 In addition, each `Page` instance carries information about the frame object which navigated to it in the `frame` property. This lets you navigate with the `frame` property as well. 
 
+
 ### The Topmost Frame
 
-The topmost frame is the frame at the root level. When navigating inside your app, you can do it with the topmost frame.
+The topmost frame is the root-level container for your app's UI and you can use it to navigate inside of your app. You can get a reference to this frame by using the `topmost()` method of the Frame module.
 
-You can get the topmost frame with the `topmost()` method of the Frame module.
 
 ``` JavaScript
 var frameModule = require("ui/frame");
@@ -138,9 +138,12 @@ import frameModule = require("ui/frame");
 var topmost = frameModule.topmost();
 ```
 
+There are several ways to perform navigation and which one to use depends on the needs of your app.
+
+
 ### Navigate by Page Name
 
-You can navigate to the topmost frame of a page specified by its file name.
+Perhaps the simplest way to navigate is by specifying the file name of the page to which you want to navigate.
 
 ``` JavaScript
 topmost.navigate("details-page");
@@ -149,9 +152,9 @@ topmost.navigate("details-page");
 topmost.navigate("details-page");
 ```
 
-### Navigate with Factory Function
+### Navigate with a Function
 
-You can specify the page to which you want to navigate by a factory function which returns the page instance.
+A more dynamic way of navigating can be done by providing a function that returns the instance of the page to which you want to navigate.
 
 ``` JavaScript
 var factoryFunc = function () {

setup/ab-setup/ab-cli-setup.md

@@ -23,8 +23,8 @@ With this IDE, you can develop for Android and iOS on Windows, OS X or Linux.
 * Windows 7 or later
 * .NET 4.0 or later
 * Node.js
-    * (Windows 7 systems): Node.js 0.10.35 or a later stable 0.x release.<br/>
-    * (Windows 8 and later systems): Node.js 0.12.7 or a later stable 0.x release<br/>A [known issue](https://github.com/SBoudrias/Inquirer.js/issues/235) in Inquirer.js prevents the interactive prompts from working properly in `cmd` shells on Windows 8 or later systems with Node.js 0.10.x.
+    * (Windows 7 systems): The latest Node.js 0.10.x or 0.12.x stable official release
+    * (Windows 8 and later systems): The latest Node.js 0.12.x stable official release
 * (Optional) For iOS development
     * (Latest official) iTunes<br/>The bitness of Node.js and iTunes must match.
 * (Optional) For Android development with the native emulators
@@ -38,10 +38,7 @@ With this IDE, you can develop for Android and iOS on Windows, OS X or Linux.
 
 1. In your browser, navigate to [https://platform.telerik.com](https://platform.telerik.com) and log in.
 1. If you do not have a Telerik account, you can log in with a social provider of your choice and begin a Telerik Platform trial.<br/>With the Telerik Platform trial, you can use the AppBuilder CLI.
-1. Install [Node.js](http://nodejs.org).
-    1. Go to [http://nodejs.org](http://nodejs.org) and click **Install**.
-    1. If prompted, confirm the download.
-    1. After the download completes, run the installer and complete the installation.
+1. Download and install the latest Node.js [0.10.x](https://nodejs.org/dist/latest-v0.10.x/) or [0.12.x](https://nodejs.org/dist/latest-v0.12.x/) stable official release.
 1. Install [Chocolatey](https://chocolatey.org) to simplify the installation and configuration of the Android tools and SDKs.
     1. Run the command prompt as an Administrator.
     1. Copy and paste the following script in the command prompt.
@@ -106,7 +103,7 @@ With this IDE, you can develop for Android and iOS on Windows, OS X or Linux.
 
 * Telerik account
 * OS X Mavericks or later
-* Node.js 0.10.35 or a later stable 0.x release
+* The latest Node.js 0.10.x or 0.12.x stable official release
 * (Optional) Homebrew to simplify the installation of dependencies
 * For iOS development
     * Xcode 5 or later
@@ -125,7 +122,7 @@ With this IDE, you can develop for Android and iOS on Windows, OS X or Linux.
     ```Shell
     ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
     ```
-1. Install [Node.js 0.10.35](http://nodejs.org) or a later stable 0.x official release.
+1. Install the latest Node.js [0.10.x](https://nodejs.org/dist/latest-v0.10.x/) or [0.12.x](https://nodejs.org/dist/latest-v0.12.x/) stable official release.
 
     ```Shell
     brew install node
@@ -202,7 +199,7 @@ With this IDE, you can develop for Android and iOS on Windows, OS X or Linux.
 
 * Telerik account
 * Ubuntu 14.04 LTS
-* Node.js 0.10.35 or a later stable 0.x release
+* The latest Node.js 0.10.x or 0.12.x stable official release
 * G++ compiler
 * (Optional) For Android development with the native emulators
     * JDK 8 or a later stable official release
@@ -214,7 +211,7 @@ With this IDE, you can develop for Android and iOS on Windows, OS X or Linux.
 1. In your browser, navigate to [https://platform.telerik.com](https://platform.telerik.com) and log in.
 1. If you do not have a Telerik account, you can log in with a social provider of your choice and begin a Telerik Platform trial.<br/>With the Telerik Platform trial, you can use the AppBuilder CLI.
 1. Run the terminal.
-1. Install [Node.js](http://nodejs.org).
+1. Install the latest Node.js [0.10.x](https://nodejs.org/dist/latest-v0.10.x/) or [0.12.x](https://nodejs.org/dist/latest-v0.12.x/) stable official release.
 
     > **TIP:** You can follow the instructions provided [here](https://github.com/joyent/node/wiki/Installing-Node.js-via-package-manager) to install Node.js on your system.
 

setup/ns-cli-setup/ns-setup-linux.md

@@ -17,7 +17,7 @@ On Linux systems, you can use the NativeScript CLI to develop only Android apps.
 ## System Requirements
 
 * Ubuntu 14.04 LTS
-* Node.js 0.10.35 or a later stable 0.x release
+* The latest Node.js 0.10.x or 0.12.x stable official release
 * G++ compiler
 * JDK 8 or a later stable official release
 * Android SDK 22 or a later stable official release
@@ -30,7 +30,7 @@ On Linux systems, you can use the NativeScript CLI to develop only Android apps.
 ## Setup
 
 1. Run the terminal.
-1. Install [Node.js](https://nodejs.org/dist/latest-v0.12.x/).
+1. Install the latest Node.js [0.10.x](https://nodejs.org/dist/latest-v0.10.x/) or [0.12.x](https://nodejs.org/dist/latest-v0.12.x/) stable official release.
 1. If you are running on a 64-bit system, install the runtime libraries for the ia32/i386 architecture.
 
     ```Shell

setup/ns-cli-setup/ns-setup-os-x.md

@@ -17,7 +17,7 @@ On OS X systems, you can use the NativeScript CLI to develop Android and iOS app
 ## System Requirements
 
 * OS X Mavericks or later
-* Node.js 0.10.35 or a later stable 0.x release
+* The latest Node.js 0.10.x or 0.12.x stable official release
 * (Optional) Homebrew to simplify the installation of dependencies
 * For iOS development
     * Latest Xcode
@@ -38,7 +38,7 @@ On OS X systems, you can use the NativeScript CLI to develop Android and iOS app
     ```Shell
     ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
     ```
-1. Install [Node.js 0.10.35](http://nodejs.org) or a later 0.12 official release.
+1. Install the latest Node.js [0.10.x](https://nodejs.org/dist/latest-v0.10.x/) or [0.12.x](https://nodejs.org/dist/latest-v0.12.x/) stable official release.
 
     ```Shell
     brew install node

setup/ns-cli-setup/ns-setup-win.md

@@ -17,7 +17,7 @@ On Windows systems, you can use the NativeScript CLI to develop only Android app
 ## System Requirements
 
 * Windows Vista or later
-* Node.js 0.10.35 or a later stable 0.x release
+* The latest Node.js 0.10.x or 0.12.x stable official release
 * (Optional) Chocolatey to simplify the installation of dependencies
 * JDK 8 or a later stable official release
 * Android SDK 22 or a later stable official release
@@ -27,7 +27,7 @@ On Windows systems, you can use the NativeScript CLI to develop only Android app
 
 ## Setup
 
-1. Install [Node.js](https://nodejs.org/dist/latest-v0.12.x/).
+1. Install the latest Node.js [0.10.x](https://nodejs.org/dist/latest-v0.10.x/) or [0.12.x](https://nodejs.org/dist/latest-v0.12.x/) stable official release.
 1. Install [Chocolatey](https://chocolatey.org) to simplify the installation and configuration of the Android tools and SDKs.
     1. Run the command prompt as an Administrator.
     1. Copy and paste the following script in the command prompt.

ui-with-xml.md

@@ -54,14 +54,14 @@ When you set the `mainModule`, the NativeScript navigation framework looks for a
 var application = require("application");
 // Set the start module for the application
 application.mainModule = "my-page";
-// Start the application
+// Start the application. Don't place any code after this line.
 application.start();
 ```
 ```TypeScript
 import application = require("application");
 // Set the start module for the application
 application.mainModule = "my-page";
-// Start the application
+// Start the application. Don't place any code after this line.
 application.start();
 ```