WORKING_GROUPS.md

   1 # io.js Working Groups
   2
   3 io.js Working Groups are autonomous projects created by the
   4 [Technical Committee (TC)](https://github.com/iojs/io.js/blob/v1.x/GOVERNANCE.md#technical-committee).
   5
   6 Working Groups can be formed at any time but must be ratified by the TC.
   7 Once formed the work defined in the Working Group charter is the
   8 responsibility of the WG rather than the TC.
   9
  10 It is important that Working Groups are not formed pre-maturely. Working
  11 Groups are not formed to *begin* a set of tasks but instead are formed
  12 once that work is already underway and the contributors
  13 think it would benefit from being done as an autonomous project.
  14
  15 If the work defined in a Working Group charter is completed the Working
  16 Group should be dissolved and the responsibility for governance absorbed
  17 back in to the TC.
  18
  19 ## Current Working Groups
  20
  21 ### Website
  22
  23 The website working group's purpose is to build and maintain a public
  24 website for the `io.js` project.
  25
  26 Its responsibilities are:
  27 * Develop and maintain a build and automation system for `iojs.org`.
  28 * Ensure the site is regularly updated with changes made to `io.js` like
  29 releases and features.
  30 * Foster and enable a community of translators.
  31
  32 The current members can be found in their
  33 [README](https://github.com/iojs/website#current-project-team-members).
  34
  35 ### Streams
  36
  37 The Streams WG is dedicated to the support and improvement of the Streams API
  38 as used in io.js and the npm ecosystem. We seek to create a composable API that
  39 solves the problem of representing multiple occurrences of an event over time
  40 in a humane, low-overhead fashion. Improvements to the API will be driven by
  41 the needs of the ecosystem; interoperability and backwards compatibility with
  42 other solutions and prior versions are paramount in importance. Our
  43 responsibilities include:
  44
  45 * Addressing stream issues on the io.js issue tracker.
  46 * Authoring and editing stream documentation within the io.js project.
  47 * Reviewing changes to stream subclasses within the io.js project.
  48 * Redirecting changes to streams from the io.js project to this project.
  49 * Assisting in the implementation of stream providers within io.js.
  50 * Recommending versions of readable-stream to be included in io.js.
  51 * Messaging about the future of streams to give the community advance notice of changes.
  52
  53 Initial members are:
  54 * @chrisdickinson
  55 * @isaacs
  56 * @rvagg
  57 * @Raynos
  58 * @calvinmetcalf
  59 * @sonewman
  60 * @mafintosh
  61 * @timgestson
  62 * @domenic
  63
  64 ### Build
  65
  66 The build working group's purpose is to create and maintain a
  67 distributed automation infrastructure.
  68
  69 Its responsibilities are:
  70 * Produce Packages for all target platforms.
  71 * Run tests.
  72 * Run performance testing and comparisons.
  73 * Creates and manages official docker images.
  74 * Creates and manages build-containers.
  75
  76 The current members can be found in their
  77 [README](https://github.com/iojs/build#people).
  78
  79 ### Tracing
  80
  81 The tracing working group's purpose is to increase the
  82 transparency of software written in io.js.
  83
  84 Its responsibilities are:
  85 * Collaboration with V8 to integrate with `trace_event`.
  86 * Maintinence and iteration on AsyncWrap.
  87 * Maintinence and improvements to system tracing support (DTrace, LTTng, etc).
  88 * Documention of tracing and debugging techniques.
  89 * Fostering a tracing and debugging ecosystem.
  90
  91 The current members can be found in their
  92 [README](https://github.com/iojs/tracing-wg#people).
  93
  94 ### i18n
  95
  96 The i18n working groups handle more than just translations. They
  97 are endpoints for community members to collaborate with each
  98 other in their language of choice.
  99
 100 Each team is organized around a common spoken language. Each
 101 language community might then produce multiple localizations for
 102 various project resources.
 103
 104 Their responsibilities are:
 105 * Translation of any io.js materials they believe are relevant to their
 106 community.
 107 * Review processes for keeping translations up
 108 to date and of high quality.
 109 * Social media channels in their language.
 110 * Promotion of io.js speakers for meetups and conferences in their
 111 language.
 112
 113 Membership is maintained by each language community.
 114
 115 * [iojs-bg](http://github.com/iojs/iojs-bg)
 116 * [iojs-bn](http://github.com/iojs/iojs-bn)
 117 * [iojs-cn](http://github.com/iojs/iojs-cn)
 118 * [iojs-cs](http://github.com/iojs/iojs-cs)
 119 * [iojs-da](http://github.com/iojs/iojs-da)
 120 * [iojs-de](http://github.com/iojs/iojs-de)
 121 * [iojs-el](http://github.com/iojs/iojs-el)
 122 * [iojs-es](http://github.com/iojs/iojs-es)
 123 * [iojs-fa](http://github.com/iojs/iojs-fa)
 124 * [iojs-fi](http://github.com/iojs/iojs-fi)
 125 * [iojs-fr](http://github.com/iojs/iojs-fr)
 126 * [iojs-he](http://github.com/iojs/iojs-he)
 127 * [iojs-hi](http://github.com/iojs/iojs-hi)
 128 * [iojs-hu](http://github.com/iojs/iojs-hu)
 129 * [iojs-id](http://github.com/iojs/iojs-id)
 130 * [iojs-it](http://github.com/iojs/iojs-it)
 131 * [iojs-ja](http://github.com/iojs/iojs-ja)
 132 * [iojs-ka](http://github.com/iojs/iojs-ka)
 133 * [iojs-ko](http://github.com/iojs/iojs-ko)
 134 * [iojs-mk](http://github.com/iojs/iojs-mk)
 135 * [iojs-nl](http://github.com/iojs/iojs-nl)
 136 * [iojs-no](http://github.com/iojs/iojs-no)
 137 * [iojs-pl](http://github.com/iojs/iojs-pl)
 138 * [iojs-pt](http://github.com/iojs/iojs-pt)
 139 * [iojs-ro](http://github.com/iojs/iojs-ro)
 140 * [iojs-ru](http://github.com/iojs/iojs-ru)
 141 * [iojs-sv](http://github.com/iojs/iojs-sv)
 142 * [iojs-ta](http://github.com/iojs/iojs-ta)
 143 * [iojs-tr](http://github.com/iojs/iojs-tr)
 144 * [iojs-tw](http://github.com/iojs/iojs-tw)
 145 * [iojs-uk](http://github.com/iojs/iojs-uk)
 146 * [iojs-vi](http://github.com/iojs/iojs-vi)
 147
 148 ### Evangelism
 149
 150 The evangelism working group promotes the accomplishments
 151 of io.js and lets the community know how they can get involved.
 152
 153 Their responsibilities are:
 154 * Project messaging.
 155 * Official project social media.
 156 * Promotion of speakers for meetups and conferences.
 157 * Promotion of community events.
 158 * Publishing regular update summaries and other promotional
 159 content.
 160
 161 The current members can be found in their
 162 [README](https://github.com/iojs/evangelism#people).
 163
 164 ### Roadmap
 165
 166 The roadmap working group is responsible for user community outreach
 167 and the translation of their concerns into a plan of action for io.js.
 168
 169 The final [ROADMAP](./ROADMAP.md) document is still owned by the TC and requires
 170 the same approval for changes as any other project asset.
 171
 172 Their responsibilities are:
 173 * Attract and summarize user community needs and feedback.
 174 * Find or potentially create tools that allow for broader participation.
 175 * Create Pull Requests for relevant changes to [Roadmap.md](./ROADMAP.md)
 176
 177 The current members can be found in their
 178 [README](https://github.com/iojs/roadmap#people).
 179
 180 ## Starting a WG
 181
 182 A Working Group is established by first defining a charter  that can be
 183 ratified by the TC. A charter is a *statement of purpose*, a
 184 *list of responsibilities* and a *list of initial membership*.
 185
 186 A working group needs 3 initial members. These should be individuals
 187 already undertaking the work described in the charter.
 188
 189 The list of responsibilities should be specific. Once established these
 190 responsibilities are no longer governed by the TC and therefore should
 191 not be broad or subjective. The only recourse the TC has over the working
 192 group is to revoke the entire charter and take on the work previously
 193 done by the working group themselves.
 194
 195 If the responsibilities described in the charter are currently
 196 undertaken by another WG then the charter will additionally have to be
 197 ratified by that WG.
 198
 199 You can submit the WG charter for ratification by sending
 200 a Pull Request to this document which adds it to the
 201 list of current Working Groups. Once ratified the list of
 202 members should be maintained in the Working Group's
 203 README.
 204
 205 ## Bootstrap Governance
 206
 207 Once the TC ratifies a charter the WG inherits the following
 208 documentation for governance, contribution, conduct and an MIT
 209 LICENSE. The WG is free to change these documents through their own
 210 governance process, hence the term "bootstrap."
 211
 212 ### *[insert WG name]* Working Group
 213
 214 The io.js *[insert WG name]* is jointly governed by a Working Group (WG)
 215 which is responsible for high-level guidance of the project.
 216
 217 The WG has final authority over this project including:
 218
 219 * Technical direction
 220 * Project governance and process (including this policy)
 221 * Contribution policy
 222 * GitHub repository hosting
 223 * Conduct guidelines
 224 * Maintaining the list of additional Collaborators
 225
 226 For the current list of WG members, see the project
 227 [README.md](./README.md#current-project-team-members).
 228
 229 ### Collaborators
 230
 231 The *[insert WG name]* GitHub repository is
 232 maintained by the WG and additional Collaborators who are added by the
 233 WG on an ongoing basis.
 234
 235 Individuals making significant and valuable contributions are made
 236 Collaborators and given commit-access to the project. These
 237 individuals are identified by the WG and their addition as
 238 Collaborators is discussed during the weekly WG meeting.
 239
 240 _Note:_ If you make a significant contribution and are not considered
 241 for commit-access log an issue or contact a WG member directly and it
 242 will be brought up in the next WG meeting.
 243
 244 Modifications of the contents of the *[insert WG repo]* repository are made on
 245 a collaborative basis. Anybody with a GitHub account may propose a
 246 modification via pull request and it will be considered by the project
 247 Collaborators. All pull requests must be reviewed and accepted by a
 248 Collaborator with sufficient expertise who is able to take full
 249 responsibility for the change. In the case of pull requests proposed
 250 by an existing Collaborator, an additional Collaborator is required
 251 for sign-off. Consensus should be sought if additional Collaborators
 252 participate and there is disagreement around a particular
 253 modification. See _Consensus Seeking Process_ below for further detail
 254 on the consensus model used for governance.
 255
 256 Collaborators may opt to elevate significant or controversial
 257 modifications, or modifications that have not found consensus to the
 258 WG for discussion by assigning the ***WG-agenda*** tag to a pull
 259 request or issue. The WG should serve as the final arbiter where
 260 required.
 261
 262 For the current list of Collaborators, see the project
 263 [README.md](./README.md#current-project-team-members).
 264
 265 ### WG Membership
 266
 267 WG seats are not time-limited.  There is no fixed size of the WG.
 268 However, the expected target is between 6 and 12, to ensure adequate
 269 coverage of important areas of expertise, balanced with the ability to
 270 make decisions efficiently.
 271
 272 There is no specific set of requirements or qualifications for WG
 273 membership beyond these rules.
 274
 275 The WG may add additional members to the WG by unanimous consensus.
 276
 277 A WG member may be removed from the WG by voluntary resignation, or by
 278 unanimous consensus of all other WG members.
 279
 280 Changes to WG membership should be posted in the agenda, and may be
 281 suggested as any other agenda item (see "WG Meetings" below).
 282
 283 If an addition or removal is proposed during a meeting, and the full
 284 WG is not in attendance to participate, then the addition or removal
 285 is added to the agenda for the subsequent meeting.  This is to ensure
 286 that all members are given the opportunity to participate in all
 287 membership decisions.  If a WG member is unable to attend a meeting
 288 where a planned membership decision is being made, then their consent
 289 is assumed.
 290
 291 No more than 1/3 of the WG members may be affiliated with the same
 292 employer.  If removal or resignation of a WG member, or a change of
 293 employment by a WG member, creates a situation where more than 1/3 of
 294 the WG membership shares an employer, then the situation must be
 295 immediately remedied by the resignation or removal of one or more WG
 296 members affiliated with the over-represented employer(s).
 297
 298 ### WG Meetings
 299
 300 The WG meets weekly on a Google Hangout On Air. The meeting is run by
 301 a designated moderator approved by the WG. Each meeting should be
 302 published to YouTube.
 303
 304 Items are added to the WG agenda which are considered contentious or
 305 are modifications of governance, contribution policy, WG membership,
 306 or release process.
 307
 308 The intention of the agenda is not to approve or review all patches,
 309 that should happen continuously on GitHub and be handled by the larger
 310 group of Collaborators.
 311
 312 Any community member or contributor can ask that something be added to
 313 the next meeting's agenda by logging a GitHub Issue. Any Collaborator,
 314 WG member or the moderator can add the item to the agenda by adding
 315 the ***WG-agenda*** tag to the issue.
 316
 317 Prior to each WG meeting the moderator will share the Agenda with
 318 members of the WG. WG members can add any items they like to the
 319 agenda at the beginning of each meeting. The moderator and the WG
 320 cannot veto or remove items.
 321
 322 The WG may invite persons or representatives from certain projects to
 323 participate in a non-voting capacity.
 324
 325 The moderator is responsible for summarizing the discussion of each
 326 agenda item and send it as a pull request after the meeting.
 327
 328 ### Consensus Seeking Process
 329
 330 The WG follows a
 331 [Consensus Seeking](http://en.wikipedia.org/wiki/Consensus-seeking_decision-making)
 332 decision making model.
 333
 334 When an agenda item has appeared to reach a consensus the moderator
 335 will ask "Does anyone object?" as a final call for dissent from the
 336 consensus.
 337
 338 If an agenda item cannot reach a consensus a WG member can call for
 339 either a closing vote or a vote to table the issue to the next
 340 meeting. The call for a vote must be seconded by a majority of the WG
 341 or else the discussion will continue. Simple majority wins.
 342
 343 Note that changes to WG membership require unanimous consensus.  See
 344 "WG Membership" above.
 345
 346 ### Developer's Certificate of Origin 1.0
 347
 348 By making a contribution to this project, I certify that:
 349
 350 * (a) The contribution was created in whole or in part by me and I
 351   have the right to submit it under the open source license indicated
 352   in the file; or
 353 * (b) The contribution is based upon previous work that, to the best
 354   of my knowledge, is covered under an appropriate open source license
 355   and I have the right under that license to submit that work with
 356   modifications, whether created in whole or in part by me, under the
 357   same open source license (unless I am permitted to submit under a
 358   different license), as indicated in the file; or
 359 * (c) The contribution was provided directly to me by some other
 360   person who certified (a), (b) or (c) and I have not modified it.
 361
 362
 363 ### Code of Conduct
 364
 365 This Code of Conduct is adapted from [Rust's wonderful
 366 CoC](https://github.com/rust-lang/rust/wiki/Note-development-policy#conduct).
 367
 368 * We are committed to providing a friendly, safe and welcoming
 369   environment for all, regardless of gender, sexual orientation,
 370   disability, ethnicity, religion, or similar personal characteristic.
 371 * Please avoid using overtly sexual nicknames or other nicknames that
 372   might detract from a friendly, safe and welcoming environment for
 373   all.
 374 * Please be kind and courteous. There's no need to be mean or rude.
 375 * Respect that people have differences of opinion and that every
 376   design or implementation choice carries a trade-off and numerous
 377   costs. There is seldom a right answer.
 378 * Please keep unstructured critique to a minimum. If you have solid
 379   ideas you want to experiment with, make a fork and see how it works.
 380 * We will exclude you from interaction if you insult, demean or harass
 381   anyone.  That is not welcome behaviour. We interpret the term
 382   "harassment" as including the definition in the [Citizen Code of
 383   Conduct](http://citizencodeofconduct.org/); if you have any lack of
 384   clarity about what might be included in that concept, please read
 385   their definition. In particular, we don't tolerate behavior that
 386   excludes people in socially marginalized groups.
 387 * Private harassment is also unacceptable. No matter who you are, if
 388   you feel you have been or are being harassed or made uncomfortable
 389   by a community member, please contact one of the channel ops or any
 390   of the TC members immediately with a capture (log, photo, email) of
 391   the harassment if possible.  Whether you're a regular contributor or
 392   a newcomer, we care about making this community a safe place for you
 393   and we've got your back.
 394 * Likewise any spamming, trolling, flaming, baiting or other
 395   attention-stealing behaviour is not welcome.
 396 * Avoid the use of personal pronouns in code comments or
 397   documentation. There is no need to address persons when explaining
 398   code (e.g. "When the developer")