Document which SASS items can be documented

[dharkness]

I've added file-level comments to a few files containing CSS rules, but they don't appear in the docs. I documented a mixin which did appear. So, what items will show up in the generated documentation once they are documented? Please list them on the Annotations page or somewhere more appropriate.

[pascalduez]

Hi,

each item need at least one comment/title above it to be registered. File level comments are just a way to apply annotations to several items at once.

[dharkness]

I was unclear, sorry. Which of these items (once documented) will appear in the docs?

• variables - yes
• mixins - yes
• functions - ?
• selectors - yes

Edit: Oops, I used // for the selector comment! It looks like everything except files is listed as an item in the final documentation. I don't see a need to list separate files so I've closed this issue.

However, it wouldn't hurt to specify each type of SASS construct that will appear in the sidebar once its documented.