Moving to SassDoc compliant comments

I moved all comments to SassDoc compliant comments. I tried running SassDoc on the file, it works like a charm.

On side notes:

* I found a couple of things that could be visually enhanced (next version of SassDoc),
* `map-json` function needs a description,
* All you have to do now is to run SassDoc and publish the generated docs somewhere. ;)