As part of our CSS review we were looking at how to document and maintain style guides. This is quite an open field but are currently trying StyleDocco.
You can write your comments in Markdown and present it along side your CSS to have examples of your HTML+CSS. It’s all in one place and rather handy.
