Without Answers

Semantics explained. Written by Honza Sládek.

November 28, 2009 at 4:32pm

home

Commenting CSS files

I think commenting your CSS files is really important thing to do. Recently I discovered cssdoc.net, a project aimed to port JavaDoc comment style to CSS. I tried to use it on one of my projects and I want to share here my comments structure and I humbly ask you for an opinion. Is it good? Do you see some space for enhancements? How do you comment your css files? I’m looking forward for your opinions, I hope we’ll together find some best practices.

Some notes:

This is the beginning of my CSS file.

This is basic structure of my CSS files for easier orientation.

This comments one part of my CSS file.

When this projects goes live I’ll share a link with you to see it in practice. Follow me on Twitter.

Notes

  1. withoutanswers posted this