Skip to content

Commit d478f2b

Browse files
committed
Miscellaneous improvements to CONTRIBUTING.md
1 parent ce0008e commit d478f2b

File tree

1 file changed

+33
-17
lines changed

1 file changed

+33
-17
lines changed

CONTRIBUTING.md

Lines changed: 33 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -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

2525
If you are familiar with a [GitHub-based pull request contribution workflow](https://help.github.com/articles/about-pull-requests/),
2626
please 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

3433
The CSS Working Group operates via the consensus of its membership, and discusses
3534
all 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

5162
Please follow the [Pull Request template](https://github.com/w3c/csswg-drafts/blob/master/.github/PULL_REQUEST_TEMPLATE.md)
5263
when 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

Comments
 (0)