diff --git a/docs/console/scaffolding.md b/docs/console/scaffolding.md index f28874f1..029e7d9d 100644 --- a/docs/console/scaffolding.md +++ b/docs/console/scaffolding.md @@ -136,7 +136,7 @@ Every file these commands write for you to edit starts with the line `//summer:m After writing the files, every `make:` command regenerates the plugin's `registry.gen.go`, which lists the plugin's models, migrations, commands, jobs and admin controllers and embeds the admin YAML (`controllers/*/*.yaml` and `models/*/*.yaml`, once they exist), and runs `go mod tidy` in the plugin. The capability methods of a scaffolded `plugin.go` return those generated lists, and its `AdminFS` (`pact.AdminAssets`) returns `generatedAdminFS()`, an empty tree until the first `make:admin-controller`. If your `plugin.go` was written by hand and does not call them, the command prints a note naming the accessors to add. -Each command prints `Created ` for every file it writes. A command refuses to overwrite an existing file or to declare a name the package already has. +Each command prints `Created ` for every file it writes. These are success lines, so `-q` hides them; run without `-q` when a script reads the created paths. A command refuses to overwrite an existing file or to declare a name the package already has. When a `make:` command cannot do its work, the error says why and what to run instead. Outside an application (no `summer.yaml` in the directory or above it) it reads: diff --git a/docs/setup/upgrading.md b/docs/setup/upgrading.md index 15c56ab1..097f3ab3 100644 --- a/docs/setup/upgrading.md +++ b/docs/setup/upgrading.md @@ -45,7 +45,7 @@ Applications pin exact versions, so a new release never reaches an application u - **Production confirmation.** `migrate`, `migrate:rollback`, `deferred:purge` and `queue:clear` ask before they run when the environment is `production` and they run on an interactive terminal; `--force` skips the question. Off a terminal, as in deploy scripts over SSH, nothing changes. - **`summer` delegates keep the binary's exit code.** Since 0.4.2 `summer migrate`, `summer serve` and the other delegated commands exit with the app binary's exit code and print only the binary's error block; 0.4.0 and 0.4.1 printed a second block and exited 1. The binary also gets the terminal again, so the production question, styled summaries and spinners work through `summer`, and its stderr no longer lands in `summer`'s stdout: a script that captured `summer route:list --json` together with log lines now gets only the JSON. - **`summer dev` runs `serve`.** It used to start the binary without a command, which printed the help and stopped; it now runs `bin/ serve` with the global options you give `summer dev`. -- **Result lines.** `summer build` ends with `Built bin/ in