CSS current work & how to participate (original) (raw)

If you want to help

Everybody can take part in the discussions on the archived mailing list www-style@w3.org. You can subscribe yourself. This is the preferred place for discussions, because the members of the working group will see them. Please, don't use this list for questions of the type How do I… Use comp. infosystems. www. authoring. stylesheets ("ciwas") or see ‘Learning CSS’.

On the mailing list, you will be talking to many people, many very busy people. Before you post, please, search the archive to see if your great idea has maybe already been discussed. Follow the usual netiquette and W3C's policies on spam, attachments, etc.

If you are sending comments on a specific CSS module, please prefix the subject of your message with the appropriate spec code (given in the ‘Status of this document’ section) in brackets, e.g. ‘[css3-flexbox] error in margin calculations’. This will help the editors find and track your comments.

Laurens Holst (a.k.a. ‘Grauw’) maintains an FAQ for www-style. (For additions, please, contact Laurens directly. Laurens is not associated with W3C.)

You can also raise issues via GitHub. Github contains copies of the editors' drafts of the CSS specifications and ‘Houdini’APIs.

Birkir Gunnarsson wrote a helpful guide Mastering GitHub with a screen reader, part 1.

If you work for a W3C member organization, you can also join the CSS working group and come to its meetings. To participate, you need to commit to (on average) 1 day per week. Contact me (Bert Bos) or your organization's W3C contact person. The group's minutes are public and posted on the CSS WG blog.

There are many ways to keep up to date with new publications by the CSS WG. The ‘What's new?’ section above shows the most recent drafts and it also has an Atom feed. Publications are announced on the CSS WG's blog and its Atom feed, and the group's Mastodon account. First drafts from all W3C working groups appear on the public-review-announce mailing list and its RSS feed. The latest publications from all W3C working groups are at the top of the Technical Reports page, which also has an RSS feed.

About the test suites

The CSS working group intends to spend a lot of time on developing the CSS test suites along with the CSS specifications. By providing a test suite for each module as soon as the module is published, we hope not only that CSS implementations will conform to the specification much earlier, but also that people will have an easier time understanding the formal text of the spec.

The test suites have their own archived mailing list public-css-testsuite@w3.org. Please send error reports, test case submissions, and any other questions and comments about the CSS test suites there. Elika Etemad maintains the CSS Testing Wiki with more info for contributors.

Raising issues via GitHub is also possible: see the Web-platform tests repository.

Mark-up con­ven­tions

The source mark-up of the specifications follows certain conventions (which is useful for automatic processing).