Consider using SassDoc

[KittyGiraudel]

SassDoc. Just sayin'. :)

[hiulit]

I'm planning on it! ;)

[hiulit]

Am I in the good path?

1174a1e
0b43044
90146b4
1a939a7

[KittyGiraudel]

Kind of. Let's keep this very simple.

1. Document your items with SassDoc comments: http://sassdoc.com/annotations/. Feel free to use /// comments if you don't want them to be output in final CSS.
2. Install SassDoc on your computer: npm install sassdoc -g.
3. Create a JSON/YML file to configure SassDoc (and its default theme): http://sassdoc.com/customising-the-view/.
4. Run sassdoc: sassdoc path/to/scss path/to/docs --config path/to/conf.json.

[hiulit]

Already done everything you said ;)

[KittyGiraudel]

Alright. Then I suggest you put the content of your docs folder in a gh-pages branch so it's online at http://hiulit.github.io/Sassy-Gridlover/. :)

[hiulit]

How do you feel about that? http://hiulit.github.io/Sassy-Gridlover/sassdoc/

[KittyGiraudel]

How do you feel about that? :)

[hiulit]

Hahaha! I feel alright!
But I have the feeling that I still have to master SassDoc...
How can I reorder the menu, to have the variable appear before the mixins? Like: http://minamarkham.github.io/sassy-starter/docs/ for example?
Do you have any ideas on how to improve my docs?

[KittyGiraudel]

You cannot. Ordering things is still not very intuitive on SassDoc.

To improve your docs:

• add basePath (docs)
• add CSS @example to show CSS output from SCSS @example perhaps

[hiulit]

Alright, thanks! :)
I'll be closing this issue then.

[hiulit]

Btw, how can I include "Sassy-Gridlover" http://hiulit.github.io/Sassy-Gridlover/sassdoc/ to "Built with SassDoc" http://sassdoc.com/built-with-sassdoc/?

[KittyGiraudel]

You can submit a PR to https://github.com/sassdoc/sassdoc.github.io. :)