I'm working on the frontend of a project which has a Perl backend. The CSS files are getting pretty big and complicated, and are in need of some documentation and Tables of Contents.
I looked at various guides, slides and blog posts where everyone suggest their own style of plain text formatting. There seems to be no good standard, making the documentation difficult to port, print, and read.
Since our other documentation is in POD (Plain Old Documentation) / perldoc I figured I could try using POD for the CSS as well, but this feels very unconventional and frankly a bit weird. I tried a simple:
/*
=pod
...
=cut
*/
and it reads fine in perldoc.
Before launch, we strip all comments from our CSS files so size would not be an issue.
Are there any other practical objections to documenting CSS with POD? Have you used some other standard to document your CSS?