Welcome to CSSDOC

This is starting as a little approach to help individuals and teams to improve writing/coding/styling/managing CSS files. The main concept is to put all the good and tested usage of DocBlock comments into CSS. That's putting style, docblocks and tags together.

Next to finding a standard approach and set of tags we are thinking about how this kind of coding standard can be used in tools that will help web stylists and web application projects.

We are coming from the FLOSS Movement (Free/Libre/Open Source Software) and do both: Webdesign and Programming. Sometimes called Front- and Backenddevelopment these days.

Team

• Tom Klingenberg - Project Manager and Specification Lead (Mainz, Germany)
• Timo Derstappen - Technical Lead (Cologne, Germany)
• Dirk Jesse - Specification, Tests and Features (Dresden, Germany); Author of YAML - Yet Another Multicolumn Layout

Project Status

We are just starting and need to setup the milestones. We have already developed some basic concepts and are running first practical tests in the wild. In case you're interested even in this very beginning of the project feel free to contact us. As of now we want to release the documentation under the GNU Free Documentation License 1.2 (GFDL) and non-trivial Sourcecode Examples or Source of Tools under GNU General Public License 1.2 (GPL). Also we'd like to create a standardization process that is both transparent and open to the public. But we do believe that even a bad coding standard is better then having none so that we will not overdo the first specification draft and put in lots of features.

CSSDOC Draft

A first Draft is available. Please checkout the Profiling section below for another way into the topic.

Contact

You can reach use by creating a ticket or by joining our mailinglist.

Profiling

Okay, this all is nice to read. So what does it look like if

I am a

• Application Developer
• Styler/CSS-Writer

In the future we want to offer the following user profiles as well:

I have created a

• Webapplication and want to know how my project can benefit
• CSS-related softwaretool and want to know how my project can support CSSDOC

I want to support the project by

• Testing the notation and reporting feedback
• Integrating it into a IDE
• Developing the Notation and writing a parser and/or validator

---

For a complete list of local wiki pages, see TitleIndex.