docs(resources-update-command): add documentation for the new resources-update command

Author: petekanev

docs/man_pages/index.md

@@ -26,6 +26,7 @@ Command | Description
 [platform list](project/configuration/platform.html) | Lists all platforms that the project currently targets.
 [platform&nbsp;remove&nbsp;`<Platform>`](project/configuration/platform-remove.html) | Removes the selected platform from the platforms that the project currently targets. This operation deletes all platform-specific files and subdirectories from your project.
 [platform update `<Platform>`](project/configuration/platform-update.html) | Updates the NativeScript runtime for the specified platform.
+[resources-update](project/configuration/resources-update.html) | Updates the App_Resources/<platform>'s internal folder structure to conform to that of an Android project.
 [prepare `<Platform>`](project/configuration/prepare.html) | Copies relevant content from the app directory to the subdirectory for the selected target platform to let you build the project.
 [build `<Platform>`](project/testing/build.html) | Builds the project for the selected target platform and produces an application package or an emulator package.
 [deploy `<Platform>`](project/testing/deploy.html) | Deploys the project to a connected physical or virtual device.

docs/man_pages/project/configuration/resources-update.md

@@ -0,0 +1,27 @@
+resources-update
+==========
+
+Usage | Synopsis
+------|-------
+`$ tns resources-update` | Defaults to executing `$ tns resources-update android`. Updates the App_Resources/Android's folder structure.
+`$ tns resources-update android` | Updates the App_Resources/Android's folder structure.
+
+Updates the App_Resources/<platform>'s internal folder structure to conform to that of an Android project. Android resource files and directories will be located at the following paths:
+- `drawable-*`, `values`, `raw`, etc. can be found at  `App_Resources/Android/src/main/res` 
+- `AndroidManifest.xml` can be found at `App_Resources/Android/src/main/AndroidManifest.xml`
+- Java source files can be dropped in at `App_Resources/Android/src/main/java` after creating the proper package subdirectory structure
+- Additional arbitrary assets can be dropped in at `App_Resources/Android/src/main/assets`
+
+### Command Limitations
+
+* The command works only for the directory structure under `App_Resources/Android`. Running `$ tns resources-update ios` will have no effect.
+
+### Related Commands
+
+Command | Description
+----------|----------
+[install](install.html) | Installs all platforms and dependencies described in the `package.json` file in the current directory.
+[platform add](platform-add.html) | Configures the current project to target the selected platform.
+[platform remove](platform-remove.html) | Removes the selected platform from the platforms that the project currently targets.
+[platform](platform.html) | Lists all platforms that the project currently targets.
+[prepare](prepare.html) | Copies common and relevant platform-specific content from the app directory to the subdirectory for the selected target platform in the platforms directory.

docs/man_pages/project/configuration/update.md

@@ -17,4 +17,5 @@ Command | Description
 [platform remove](platform-remove.html) | Removes the selected platform from the platforms that the project currently targets.
 [platform](platform.html) | Lists all platforms that the project currently targets.
 [prepare](prepare.html) | Copies common and relevant platform-specific content from the app directory to the subdirectory for the selected target platform in the platforms directory.
-[platform update](platform-update.html) | Updates the NativeScript runtime for the specified platform.
+[platform update](platform-update.html) | Updates the NativeScript runtime for the specified platform.
+[resources-update android](resources-update.html) | Updates the App_Resources/Android directory to the new v4.0 directory structure

lib/commands/resources-update.ts

@@ -13,7 +13,8 @@ export class ResourcesUpdateCommand implements ICommand {
 
     public async canExecute(args: string[]): Promise<boolean> {
         if (!args || args.length === 0) {
-            this.$errors.failWithoutHelp("No platform specified. Please specify a platform to update. Valid platforms are: 'android'");
+            // Command defaults to migrating the Android App_Resources, unless explicitly specified
+            args = ["android"];
         }
 
         for (const platform of args) {

lib/services/project-v4-migration-service.ts

@@ -6,11 +6,9 @@ export class ProjectV4MigrationService implements IProjectV4MigrationService {
     private static ANDROID_DIR_TEMP = "Android-Updated";
     private static ANDROID_DIR_OLD = "Android-Pre-v4";
 
-    constructor(
-        private $fs: IFileSystem,
+    constructor(private $fs: IFileSystem,
         private $logger: ILogger,
-        private $devicePlatformsConstants: Mobile.IDevicePlatformsConstants
-    ) { }
+        private $devicePlatformsConstants: Mobile.IDevicePlatformsConstants) { }
 
     canMigrate(platformString: string): boolean {
         if (platformString.toLowerCase() === this.$devicePlatformsConstants.iOS.toLowerCase()) {
@@ -50,12 +48,12 @@ export class ProjectV4MigrationService implements IProjectV4MigrationService {
             shell.cp("-Rf", dir, appResourcesMainSourceSetResourcesDestination);
         });
 
-        // move the pre-v4 app_resources in ANDROID_DIR_OLD
+        // rename the pre-v4 app_resources to ANDROID_DIR_OLD
         shell.mv(originalAppResources, path.join(appResourcesDir, ProjectV4MigrationService.ANDROID_DIR_OLD));
         // move the new, updated app_resources to App_Resources/Android, as  the de facto resources
         shell.mv(appResourcesDestination, originalAppResources)
 
-        this.$logger.out(`Successfully updated your project's App_Resources/Android directory structure. The previous version of App_Resources/Android has been renamed to App_Resources/${ProjectV4MigrationService.ANDROID_DIR_OLD}`);
+        this.$logger.out(`Successfully updated your project's App_Resources/Android directory structure.\nThe previous version of App_Resources/Android has been renamed to App_Resources/${ProjectV4MigrationService.ANDROID_DIR_OLD}`);
     }
 
 }