docs: update readme and cli to document new "develop" functionality

Author: rorycl

README.md

@@ -21,9 +21,15 @@ Download the `firstgo` binary for your platform from
 
 `firstgo` runs in `demo`, `init` or `serve` modes:
 
-* **demo**: `./firstgo demo` runs the embedded demo to show how `firstgo` works
-* **init**: `./firstgo init` initialises a new project by writing the demo project to disk
-* **serve**: `./firstgo serve config.yaml` serves project files from disk
+* **demo**: `./firstgo demo` runs the embedded demo to show how
+  `firstgo` works
+* **init**: `./firstgo init` initialises a new project by writing the
+  demo project to disk
+* **serve**: `./firstgo serve config.yaml` serves project files from
+  disk
+* **develop**: `./firstgo develop config.yaml` serves project files from
+  disk with automatic reloads after changes to `config.yaml` and
+  template files.
 
 To deploy your custom content in production, either copy your project
 files with the binary to your production setting, or copy your project
@@ -56,24 +62,26 @@ set out in [utils](./utils/).
 ./firstgo -h
 
 NAME:
-   firstgo - A web server for prototyping web interfaces from sketched images.
+   firstgo - A web server for prototyping web interfaces from sketches
 
 USAGE:
    firstgo [global options] [command]
 
 DESCRIPTION:
-   The server uses a config.yaml file to describe clickable zones on
-   images in assets/images to build an interactive website.
+   The firstgo server uses a config.yaml file to describe clickable
+   zones on images in assets/images to build an interactive website.
    
    For a demo with embedded assets and config file, use 'demo'.
    To start a new project, use 'init' to write the demo files to disk.
    To serve files on disk use 'serve'.
+   To serve files on disk in development mode use 'develop'.
 
 COMMANDS:
-   serve  Serve content on disk with the provided config
-   init   Initialize a new project in a directory
-   demo   Run the embedded demo server
-   help   Shows a list of commands or help for one command
+   serve    Serve content on disk
+   develop  Serve content on disk with automatic file reloads
+   init     Initialize a new project in a directory
+   demo     Run the embedded demo server
+   help     Shows a list of commands or help for one command
 
 Run 'firstgo [command] --help' for more information on a command.
 ```

cli.go

@@ -13,12 +13,13 @@ import (
 
 const (
 	ShortUsage      = "A web server for prototyping web interfaces from sketches"
-	LongDescription = `The server uses a config.yaml file to describe clickable zones on
-   images in assets/images to build an interactive website.
+	LongDescription = `The firstgo server uses a config.yaml file to describe clickable
+   zones on images in assets/images to build an interactive website.
    
    For a demo with embedded assets and config file, use 'demo'.
    To start a new project, use 'init' to write the demo files to disk.
-   To serve files on disk use 'serve'.`
+   To serve files on disk use 'serve'.
+   To serve files on disk in development mode use 'develop'.`
 )
 
 // Applicator is an interface to the central coordinator for the project
@@ -50,7 +51,7 @@ func BuildCLI(app Applicator) *cli.Command {
 
 	serveCmd := &cli.Command{
 		Name:      "serve",
-		Usage:     "Serve content on disk with the provided config",
+		Usage:     "Serve content on disk",
 		ArgsUsage: "CONFIG_FILE",
 		// use the common flags
 		Flags: []cli.Flag{
@@ -81,8 +82,8 @@ func BuildCLI(app Applicator) *cli.Command {
 	}
 
 	serveInDevelopmentCmd := &cli.Command{
-		Name:      "development",
-		Usage:     "Serve from disk in development mode",
+		Name:      "develop",
+		Usage:     "Serve content on disk with automatic file reloads",
 		ArgsUsage: "CONFIG_FILE",
 		// use common flags
 		Flags: []cli.Flag{

cli_test.go

@@ -99,20 +99,20 @@ func TestParseCLI(t *testing.T) {
 		},
 		{
 			name: "development all options",
-			args: []string{"program", "development", "-a", "127.0.0.1", "-p", "8001", "-s", "html", "config.yaml"},
+			args: []string{"program", "develop", "-a", "127.0.0.1", "-p", "8001", "-s", "html", "config.yaml"},
 		},
 		{
 			name: "development only config",
-			args: []string{"program", "development", "config.yaml"},
+			args: []string{"program", "develop", "config.yaml"},
 		},
 		{
 			name:            "development no config",
-			args:            []string{"program", "development", "--address", "127.0.0.2"},
+			args:            []string{"program", "develop", "--address", "127.0.0.2"},
 			wantErrContains: "missing required argument",
 		},
 		{
 			name:            "development no suffix",
-			args:            []string{"program", "development", "-a", "127.0.0.1", "-p", "8001", "-s", "", "config.yaml"},
+			args:            []string{"program", "develop", "-a", "127.0.0.1", "-p", "8001", "-s", "", "config.yaml"},
 			wantErrContains: "empty suffix argument",
 		},
 	}