sindresorhus / grunt-sass

Compile Sass to CSS
MIT License
1.01k stars 209 forks source link

Improves readability on Usage docs #294

Closed hunkjazz closed 5 years ago

hunkjazz commented 5 years ago

I'm a newbie learning Grunt and had a hard time, searching for what some objects are meant for. Even though it seems really easy to me now, I can't say that it won't happen again to another person, as this issue shows.

If you think that the latest commit is too verbose , I'm able to open another PR in which we just reference the Grunt documentation "Building the files object dynamically":

Besides that, if you want to glob and render a whole Sass folder easily, you should read the "Building the files object dynamically" on Grunt documentation for configuring tasks.

sindresorhus commented 5 years ago

Thanks for the suggestion, but each Grunt task should not need to document everything about Grunt. All Grunt tasks have the same config structure, so it's better documented in one place. If the Grunt docs are lacking, you should rather try to improve those.