List out more CLI commands and give more `ember help` guidance about cli-guides

[neojp]

@jenweber I have submitted the PR #207 using the WP-CLI Commands page as a reference. It includes the following:

• Added tables of contents with links to each command
• Added anchored headings to each command
• Added description to each command

Note: This isn't included in this PR, but I think we should add additional information about ember generate blueprints.

Screenshots

---

---

[jenweber]

Thanks everyone for the help! The new page is live with several improvements from multiple people ❤️

[mehulkar]

Instead of trying to come up with a complete list, i'd recommend removing everything from the Guides and simply telling people to use ember help. Any specific issues should be filed as such.

[fozy81]

@jenweber I'm interested to help. I've put together a work in progress PR listing all the commands. But not quite sure exactly what format we are aiming for. Do we want almost a screen dump of ember --help or add more description for each command/options 🤔 . Anyway, happy to help, it's a really good learning experience discovering useful commands/options I've not used before 😄 - no matter what form it finally ends up in.

[jenweber]

Hi @fozy81, thanks for your help! I think we could start with a screen dump, and if that seems insufficient, that’sa good signal that we need to update the CLI help text as well. We already have a page with longer descriptions for the most common commands, aimed at beginners. So this new page can be more like a reference.

@mehulkar that was my initial plan for the Guides, but the learning team has received consistent feedback that people are looking for the reference list and they go back to the old site for it. Now that we are redirecting people from the old site, I think we should cover it. I think we still need to emphasize strongly that people should use help as their first stop.

[fozy81]

Hi @jenweber @mehulkar I've updated the PR with a screen dump of ember --help and added a note to use ember --help for the most up to date info/version. It looks okay on mobile, I added line breaks into the bash output at around 60 characters per line so it fits better on to a small screen without overflowing.

Does this fulfill the feedback/issue - let me know if anything needs changing or what your reflections on this change are? Do you think there are specific reference page(s) from the old CLI website we need to re-create to fulfill the feedback people have been providing? Perhaps the ember commands table on this page?

Slightly off topic, one thing that crossed my mind is that the ember guides point new users towards javascript, html and css tutorials/info but it's feasible that our audience 'who knows enough to have built a simple HTML/JavaScript (or JQuery) app' may not be familiar with CLI tools. What do you think about pointing new users towards a CLI tutorial to help gain familiarity with the CLI itself, if required?

[neojp]

@jenweber Now that we have merged #207, I have sent a new PR with the remaining ember generate blueprints on #208.

Hopefully with this we can finally close this issue.

I'd love to figure out a way to automate this process to avoid this manual process if the documentation for the scripts change, but that could live under a separate issue if we ever get to that.