Show default values for each command flag

[muuvmuuv]

🚀 Feature request

Today I started a new NG9 project and first things first I have set up CLI commands, packages and so on. While doing that, I was wondering what defaults are being set by the CLI and couldn't find any reference in the docs.

Let's say ng serve --hmr, is HMR not enabled by default? Those are questions I ask myself and I think others that are starting with NG as well. To make that easier. We should add the default value behind every flag:

ng server --help
...
  --hmr
    Enable hot module replacement. (default: true)

At the moment my command looks like that:

ng serve --watch --live-reload --aot --hmr --open --progress --source-map

Because I'm not sure if any of them are true by default. Sure, I expect them to be true but I'm not sure. My previous projects were developed through Ionic CLI which had handled that ng serve under the hood.

Command (mark with an x)

• new
• build
• serve
• test
• e2e
• generate
• add
• update
• lint
• xi18n
• run
• config
• help
• version
• doc

Describe alternatives you've considered

A note in the docs

[dgp1130]

Just to add a little more context, there are several different kinds of "defaults" in builders.

• The default which is hard-coded in the builder itself.
• The default specified in the user's configuration.
• The default specified in the workspace.
• The default specified in the project.

So including the text (default: true) is a bit of an oversimplification, and users might be surprised to find that the flag is actually false due to some project configuration.

I definitely agree that we should be more transparent about this, but whatever solution we come up with here needs to take all these different configurations into account.

[muuvmuuv]

Over a year old and I am still opening JSON schema files to find default values. Just saying. Even with the latest "prod by default" I am not certain. Would really help. Maybe we can extend this and integrate into Editors for example in VS Code showing the default value as an annotation like Gitlens shows the edit history next to a line. Would love this. VS Code btw has this issue as well, where when I am overriding values with its default value ^^, IDK.

[angular-robot]

Just a heads up that we kicked off a community voting process for your feature request. There are 20 days until the voting process ends.

Find more details about Angular's feature request process in our documentation.