Closed
Description
If someone has come to addon-docs for the first time and is starting to install it, the first thing they'll do is run ember install ember-cli-addon-docs
. The CLI prompt then asks "Which documentation style would you like to use?" and provides two options: YUIDoc & ESDoc. The user likely has no context as to why they would choose one over the other, and there is no option to opt-out of this choice and install the appropriate plugin separately in the future. Even more confusingly, the official Quickstart guides make no mention of this prompt and instead recommend installing the plugins separately.
There are a couple of conflated issues here:
- There is no context for how to choose between the two options presented.
- If you don't know how to choose, there is no option to defer that choice and install the plugins separately.
- The Quickstart guides are written in a way that implies there IS a way to defer that choice and expects you to install them separately.
Metadata
Metadata
Assignees
Labels
No labels