-
Notifications
You must be signed in to change notification settings - Fork 126
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Getting started should explain what Grunt actually does #196
Comments
The Grunt homepage should answer all your questions. Taken from the homepage:
|
We have to agree with @JamesHurburgh. Respectfully, the homepage does not answer questions that beginners have--not even remotely. There is a lot of information throughout the site, but it is pretty indigestible. Strengthening the first description of Grunt could go a long way to helping. Perhaps a rewrite of that paragraph along the following lines?
The Getting Started sections are also a bit of a slog to understand. Those sections should be especially clear on what users must do themselves vs what Grunt handles out-of-the-box. Passive verb tenses are used both when describing features and when explaining required action. We recommend re-writing this section with imperative verb tenses. Give readers a set of instructions. Start each with the verb. End each with the object of the sentence. @JamesHurburgh, does the above proposal seem in line with what you had in mind? Clearly the above can be improved further; ideally it gives a useable staring notion. Grunt is truly among the great projects in open source. Kudos to the team and the community! |
Thanks for putting the effort into making this easier for new comers. That paragraph is descriptive and useful. Since you have a new issue to track the work I'll close this one. |
New to javascript web dev, I have no idea what Grunt is but I've heard the name and it sounds useful. So I go to 'Getting started' and I get 3 paragraphs on how it is installed and managed, then how to install the command line interface.
Then this: "Each time grunt is run, it looks for a locally installed Grunt using" What the heck is a Grunt? I thought that's why I was reading this page.
TLDR; The documentation is inaccessible to people who don't already know what Grunt is.
The text was updated successfully, but these errors were encountered: