[Design with CSS 3776] Re: Need help on CSS DOC

JS Doc should have no problem parsing the doc out of a css file, so you could just use that.

It especially makes sense if you use a css pre-processor like sass where you deal with variables and functions also

Those also strip out any inline comments, so you can freely add as much information inline as you'd like.

But for the usefullness of the documentation, that totally depends on which css method you use.

There is a method called OOCSS wich would if done right lend itself for documentation.

Because there is no real inheritance in css, but that is done in the html i think both are too tightly coupled to be documented alone.

(like what would happen if you replace all html tags with span tags, would everything still work?, this is a bad example ofcourse but i think you know what i mean

in css we reset to a style wich all browsers agree on and build from there, but your css on top of that should work on most html constructs)

What i normally do is create a html cheat page on wich all styles with their accompany-ing html are showcased.

best

/paul

On Tuesday, October 9, 2012 5:07:56 PM UTC+2, Kiran Kumar Kendole wrote:

Hey All ,

We have a requirement of implementing CSS DOCs for all our stylesheets. Do we have any tool for this development similarly like one we have for JS DOCs ? 
Appreciate if you can send me some posts, blogs, reference links for CSS DOC.

Thanks,

Kiran K Kumar

--
--
You received this because you are subscribed to the "Design the Web with CSS" at Google groups.
To post: css-design@googlegroups.com
To unsubscribe: css-design-unsubscribe@googlegroups.com