@@ -14,7 +14,7 @@ in the relevant W3C Working Group or make a non-member patent licensing commitme
1414
1515## Issue disclosure and discussion
1616
17- The first step for any contribution, substantive or not, is to either:
17+ The first step for any substantive contribution is to either:
1818
1919 1 . [ Find an existing issue] ( https://github.com/w3c/csswg-drafts/issues ) directly related to the contribution
2020 2 . [ Add a new issue] ( https://github.com/w3c/csswg-drafts/issues/new )
@@ -24,29 +24,40 @@ that the eventual consensus can be turned into official specification language.
2424
2525If you are familiar with a [ GitHub-based pull request contribution workflow] ( https://help.github.com/articles/about-pull-requests/ ) ,
2626please note that ** most issues are subject to quite a bit of discussion** before
27- draft language becomes ready for a pull request. Please ensure the full problem
28- space of the issue is explored in the discussion, and that consensus has been reached
29- by the participating members, before contributing to the
30- repository.
27+ they are ready for a pull request with specific wording changes. Please ensure
28+ the full problem space of the issue is explored in the discussion, and that
29+ consensus has been reached by the participants, before drafting a pull request.
3130
3231## Normative and/or substantive contributions
3332
3433The CSS Working Group operates via the consensus of its membership, and discusses
3534all significant matters prior to implementation.
3635
37- If adding an new, normative issue, please label/tag the PR as 'Agenda+' to bring
38- it to the Working Group's attention.
36+ The Editors responsible for a particular spec are responsible for triaging their
37+ issues on a regular basis; however note that sometimes this can take awhile
38+ (anywhere from a few days to a few years) depending on the complexity of the
39+ issue and the work schedules of people involved--this does not mean we are
40+ ignoring the issue.
3941
40- The Working Group, aside from managing issues on GitHub, mainly discusses specifications
41- and requests on [ the www-style public mailing list] ( https://lists.w3.org/Archives/Public/www-style/ ) ,
42- and in CSSWG meetings.
42+ For an issue that requires WG discussion or approval, WG members can tag/label
43+ it 'Agenda+' to bring it to the Working Group's attention. Unfortunately,
44+ GitHub doesn't allow labelling permissions without repository write permissions,
45+ so if you believe an issue is urgent or discussion has stalled for awhile and
46+ the WG's attention is needed to move forward, ask one of the editors to flag it.
47+
48+ The Working Group, aside from managing issues on GitHub, mainly discusses
49+ specifications and requests on [ the www-style public mailing list] ( https://lists.w3.org/Archives/Public/www-style/ ) ,
50+ and in CSSWG meetings, whose minutes are posted to www-style.
4351
4452### After discussion
4553
46- Once the Working Group has come to a consensus, a contributor may file a pull request
47- against the issue. The editor of the specification related to the issue will then be
48- responsible for reviewing both the content and implementation of the contributed
49- changes.
54+ Once the Working Group has come to a consensus, the editor may draft up and
55+ commit the relevant changes for review by other contributors or a contributor
56+ may file a pull request against the issue for review by the editor(s). Since
57+ specification wording is tricky, it is strongly recommended that the editors
58+ of that particular spec be involved, either as originator or as reviewer, in
59+ any changes. We also encourage other participants in the issue discussion to
60+ review the changes and request corrections or improvements as necessary.
5061
5162Please follow the [ Pull Request template] ( https://github.com/w3c/csswg-drafts/blob/master/.github/PULL_REQUEST_TEMPLATE.md )
5263when contributing to the repository.
@@ -70,6 +81,11 @@ The pre-CR specifications with this testing requirement are currently:
7081
7182## Non-substantive contributions
7283
73- For simple spelling, grammar, or markup fixes unrelated to the substance of a specification,
74- please file an issue with the usual shortname tagging (ie. ` [css-foo] ` ) for the spec(s)
75- edited by the change. You may then issue a pull request referencing the issue number.
84+ For simple spelling, grammar, or markup fixes unrelated to the substance of a
85+ specification, issuing a pull request without a corresponding issue is acceptable.
86+
87+ ## Further information
88+
89+ See [ about: csswg ] ( http://fantasai.inkedblade.net/weblog/2011/inside-csswg/ )
90+ for more information on how the CSSWG operates, delegates authority, and
91+ makes decisions. Someday maybe we'll also have a useful official website.
0 commit comments