refactor: update commands description

Author: thetutlage

commands/Build.ts

@@ -15,7 +15,8 @@ import { BaseCommand, flags } from '@adonisjs/core/build/standalone'
  */
 export default class Build extends BaseCommand {
   public static commandName = 'build'
-  public static description = 'Compile Typescript code to JavaScript'
+  public static description =
+    'Compile project from Typescript to Javascript. Also compiles the frontend assets if using webpack encore'
 
   /**
    * Build for production
@@ -27,7 +28,8 @@ export default class Build extends BaseCommand {
    * Bundle frontend assets. Defaults to true
    */
   @flags.boolean({
-    description: 'Bundle frontend assets when encore is installed. Use --no-assets to disable',
+    description:
+      'Build frontend assets when webpack encore is installed. Use --no-assets to disable',
     default: true,
   })
   public assets: boolean

commands/Invoke.ts

@@ -11,18 +11,18 @@ import { BaseCommand, args } from '@adonisjs/core/build/standalone'
 import { Manifest } from '../src/Manifest'
 
 /**
- * Invoke post install instructions
+ * Configure a package
  */
-export default class Invoke extends BaseCommand {
-  public static commandName = 'invoke'
-  public static description = 'Run post install instructions for a given AdonisJS package'
-  public static aliases = ['configure']
+export default class Configure extends BaseCommand {
+  public static commandName = 'configure'
+  public static description = 'Configure a given AdonisJS package'
+  public static aliases = ['invoke']
 
   /**
    * Use yarn when building for production to install dependencies
    */
   @args.string({
-    description: 'Name of the package for which to invoke the post install instructions',
+    description: 'Name of the package you want to configure',
   })
   public name: string
 

commands/Make/Controller.ts

@@ -46,7 +46,7 @@ export default class MakeController extends BaseGenerator {
   @args.string({ description: 'Name of the controller class' })
   public name: string
 
-  @flags.boolean({ description: 'Adds resourceful methods to the controller class', alias: 'r' })
+  @flags.boolean({ description: 'Add resourceful methods to the controller class', alias: 'r' })
   public resource: boolean
 
   @flags.boolean({

commands/Make/Exception.ts

@@ -28,16 +28,16 @@ export default class MakeException extends BaseGenerator {
    * Command meta data
    */
   public static commandName = 'make:exception'
-  public static description = 'Make a new exception handle'
+  public static description = 'Make a new custom exception class'
 
   @args.string({ description: 'Name of the exception class' })
   public name: string
 
-  @flags.boolean({ description: 'Add handle method to self handle the exception' })
+  @flags.boolean({ description: 'Add the handle method to self handle the exception' })
   public selfHandle: boolean
 
   @flags.boolean({
-    description: 'Create the exception with the exact name as provided',
+    description: 'Create the exception class with the exact name as provided',
     alias: 'e',
   })
   public exact: boolean

commands/Make/PreloadFile.ts

@@ -36,8 +36,7 @@ export default class MakePreloadFile extends BaseGenerator {
   /**
    * Command description
    */
-  public static description =
-    'Make a new preload file. Preloaded files are loaded automatically on boot'
+  public static description = 'Make a new preload file'
 
   @args.string({ description: 'Name of the file' })
   public name: string

commands/Make/Provider.ts

@@ -30,12 +30,12 @@ export default class MakeProvider extends BaseGenerator {
    * Command meta data
    */
   public static commandName = 'make:provider'
-  public static description = 'Make a new IoC container provider'
+  public static description = 'Make a new provider class'
 
   @args.string({ description: 'Name of the provider class' })
   public name: string
 
-  @flags.boolean({ description: 'Registers provider under the ace providers array' })
+  @flags.boolean({ description: 'Register provider under the ace providers array' })
   public ace: boolean
 
   @flags.boolean({

commands/Serve.ts

@@ -15,7 +15,8 @@ import { BaseCommand, flags } from '@adonisjs/core/build/standalone'
  */
 export default class Serve extends BaseCommand {
   public static commandName = 'serve'
-  public static description = 'Start the AdonisJS HTTP server. Optionally watch for file changes'
+  public static description =
+    'Start the AdonisJS HTTP server, along with the file watcher. Also starts the webpack dev server when webpack encore is installed'
 
   public static settings = {
     stayAlive: true,
@@ -25,15 +26,18 @@ export default class Serve extends BaseCommand {
    * Bundle frontend assets. Defaults to true
    */
   @flags.boolean({
-    description: 'Start webpack dev server when encore is installed. Use --no-assets to disable',
+    description: 'Start webpack dev server when encore is installed. Use "--no-assets" to disable',
     default: true,
   })
   public assets: boolean
 
   /**
    * Allows watching for file changes
    */
-  @flags.boolean({ description: 'Watch for file changes and re-start the HTTP server', alias: 'w' })
+  @flags.boolean({
+    description: 'Watch for file changes and re-start the HTTP server on change',
+    alias: 'w',
+  })
   public watch: boolean
 
   /**

package.json

@@ -43,7 +43,7 @@
   },
   "homepage": "https://github.com/adonisjs/assembler#readme",
   "devDependencies": {
-    "@adonisjs/ace": "^9.0.3",
+    "@adonisjs/ace": "^9.0.4",
     "@adonisjs/core": "^5.0.5-canary-rc-1",
     "@adonisjs/mrm-preset": "^3.0.0",
     "@poppinss/dev-utils": "^1.1.0",