CSS is the acronym for: ‘Cascading Style Sheets’. CSS is an extension to basic HTML that allows you to style your web pages.
CSSDOC is a convention to comment Cascading Style Sheets (CSS) to help individuals and teams to improve writing/coding/styling/managing CSS files. It is an adoption of the well known JavaDoc / DocBlock based way of commenting source-code. That's putting style, docblocks and tags together.
Because CSS has not such an explicit commanding character then program-source-code that will be compiled or executed later, the scope what is documented differs compared to the programming languages. Anyway, the benefits of using CSSDOC is mutual and will hopefully help to further develop:
- CSS-Authors can use it to beautify their CSS files and to find a convention they can refer to while sharing files with other authors, writers, designers, webapp devs, creative-theme-directors, ... .
- Software developers can use it to provide more comfortable capabilities inside their software for CSS-Authors and vice versa.
- Application and tools can use CSSDOC to gather additional data from CSS files an author has written down.
|
