Refining

Author: Iva Koevska

resources/help.txt

@@ -8,10 +8,11 @@ General commands:
 
     create                          Creates a new project for native development with NativeScript.
     platform add                    Configures the current project to target the selected platform.
-    platform list                   Lists all target platforms for the current project.
-    platform remove                 Removes the platform specific project.
+    platform list                   Lists all platforms that the project currently targets.
+    platform remove                 Removes the selected platform from the platforms that the project currently targets.
+                                    This operation deletes all platform-specific files and subdirectories from your project.
     prepare                         Copies cross-platform content to the subdirectory for the selected target platform. 
-                                    This lets you build the project with the SDK for the selected platform.
+                                    This lets you build the project with the SDK for the selected platform and deploy it on device.
     build                           Builds the project for the selected target platform and produces an application package.
     run                             Runs your project on a connected device. This is shorthand for prepare, build, and deploy.
 
@@ -37,17 +38,18 @@ Lists the available commands or shows information about the selected command.
 Usage:
     $ tns create <App name> [--path <Directory>] [--appid <App ID>] [--copy-from <Directory>]
 
-Creates a new NativeScript project.
-<App name> is the name of project. The specified name must comply with the limitations of the target platform. 
-           For example, the name of a project that targets Android must not begin with a number because classes in Java
-           cannot begin with numbers.
+Creates a new project for native development with NativeScript.
+<App name> is the name of project. The specified name must meet the requirements of all platforms that you want to target. 
+           For projects that target Android, you can use uppercase or lowercase letters, numbers, and underscores. The name must start with a letter.
+           For projects that target iOS, you can use uppercase or lowercase letters, numbers, and hyphens. 
 
 Options:
     --path - Specifies the directory where you want to create the project, if different from the current directory.
             The directory must be empty.
-    --appid - Sets the application identifier for your project. The application identifier must consist of at least three
-              alphanumeric strings, separated by a dot (.). Each string must start with a letter.
-              The application identifier corresponds to the Bundle ID for iOS apps and to the package identifier for Android apps.
+    --appid - Sets the application identifier for your project. The application identifier must be a domain name in reverse and must
+              meet the requirements of all platforms that you want to target.
+              For projects that target Android, you can use uppercase or lowercase letters, numbers, and underscores in the strings of the reversed domain name, separated by a dot. Strings must be separated by a dot and must start with a letter. For example: com.nativescript.My_Andro1d_App
+              For projects that target iOS, you can use uppercase or lowercase letters, numbers, and hyphens in the strings of the reversed domain name. Strings must be separated by a dot. For example: com.nativescript.My-i0s-App
               If not specified, the application identifier is set to com.telerik.<App name>.
     --copy-from - Specifies a directory which contains custom assets that you want to use in your NativeScript project. If not set,
                   the default hello-world template is used.
@@ -62,9 +64,13 @@ Usage:
 You must run the platform command with a related command.
 
 <Command> is a related command that extends the platform command. You can run the following related commands:
-    list - Lists all target platforms for the current project.
-    add - Configures the current project to target the selected platform.
-    remove - Removes the deployment capabilities of a project for the specified platform
+    list - Lists all platforms that the project currently targets. You can build and deploy your project only for 
+           the active target platforms.
+    add - Configures the current project to target the selected platform. After adding the target platform, you can 
+          build and deploy your app to it.
+    remove - Removes the selected platform from the platforms that the project currently targets. After removing 
+             the target platform, you can no longer build and deploy your app to it.
+             This operation deletes all platform-specific files and subdirectories from your project.
 
 --[/]--
 
@@ -73,7 +79,7 @@ You must run the platform command with a related command.
 Usage:
     $ tns platform list
 
-Lists all target platforms for the current project.
+Lists all platforms that the project currently targets. You can build and deploy your project only for the active target platforms.
 
 --[/]--
 
@@ -86,14 +92,13 @@ Platform-specific usage:
     $ tns platform add android
     $ tns platform add ios
 
-Configures the current project to target the selected platform. In this version of Telerik NativeScript, 
-you can target iOS and Android, based on your system. You need to have your system configured for development with the target 
-platform.
+Configures the current project to target the selected platform. When you add a target platform, the Telerik NativeScript CLI adds a corresponding platform-specific subdirectory under the platforms directory. This platform-specific directory contains the necessary files to let you build your project for the target platform.
+
+In this version of Telerik NativeScript, you can target iOS and Android, based on your system. You need to have your system configured for development with the target platform.
 On Windows systems, you can target Android. 
 On OS X systems, you can target Android and iOS.
 
-When you add a target platform, the Telerik NativeScript CLI adds a corresponding platform-specific subdirectory under the platforms
-directory. This platform-specific directory contains the necessary files to let you build your project for the target platform.
+
 --[/]--
 
 --[platform|remove]--
@@ -105,7 +110,9 @@ Platform-specific usage:
     $ tns platform remove android
     $ tns platform remove ios
 
-Removes the deployment capabilities of a project for the specified platform.
+Removes the selected platform from the platforms that the project currently targets. After removing the target platform, you can no longer build and deploy your app to it.
+
+This operation deletes all platform-specific files and subdirectories from your project.
 
 --[/]--
 
@@ -132,7 +139,7 @@ Platform-specific usage:
     $ tns build android
     $ tns build ios
 
-Builds the project for the selected target platform. This generates platform-specific code within the platforms subdirectory
+Builds the project for the selected target platform. This generates platform-specific code within the platform subdirectory
 in the project.
 
 --[/]--
@@ -146,7 +153,7 @@ Platform-specific usage:
     $ tns run android
     $ tns run ios
 
-This is shorthand for prepare and build.
+Runs your project on a connected device. This is shorthand for prepare, build, and deploy.
 
 --[/]--