Skip to content

Commit

Permalink
Add a section on how Mozilla's subject-matter experts should contribu…
Browse files Browse the repository at this point in the history
…te. (mozilla#358)

When I've solicited feedback from subject-matter experts within Mozilla,
I've been asked a number of questions what sort of feedback is useful
and how to provide it.  This attempts to write down the advice I've
given so that it's in one place and so that we can get wider agreement
on what that advice should be.
  • Loading branch information
dbaron authored Jun 11, 2020
1 parent 51bfa93 commit 1354cbd
Showing 1 changed file with 48 additions and 1 deletion.
49 changes: 48 additions & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,11 +62,12 @@ If successful, it will modify `activities.json` with the new specification. Chec
{
"ciuName": "The short tagname from caniuse.com for the feature, if available",
"description": "A textual description; often, the spec's abstract",
"id": "A fragment identifier for the positions table",
"mozBugUrl": "The URL of the Mozilla bug tracking this specification, if available",
"mozPosition": "under consideration",
"mozPositionIssue": the number of the issue in this repo, if available,
"mozPositionDetail": "more information about Mozilla's position",
"org": one of ['IETF', 'W3C', 'WHATWG', 'Ecma', 'Other'],
"org": one of ['IETF', 'W3C', 'WHATWG', 'Ecma', 'Unicode', 'Proposal', 'Other'],
"title": "The spec's title",
"url": "The canonical URL for the most recent version of the spec"
}
Expand All @@ -86,6 +87,8 @@ assessment.

## Discussing Mozilla's Position on a Web Specification

### For the Broader Community

We welcome discussion members of the wider Mozilla community -- including the public -- but ask
that it be on-topic, and that it follow [Mozilla's Community Participation
Guidelines](https://www.mozilla.org/about/governance/policies/participation/).
Expand All @@ -103,3 +106,47 @@ issue or a specific comment.
If an issue becomes overwhelmed by excessive advocacy, comments might be deleted, and the
issue might be locked.

### For Mozilla's Subject-Matter Experts

The purpose of this repository is to help
Mozilla's technical leaders reach a consensus position
about new Web features being proposed.
Therefore, you might be asked for your opinion
on specifications where you are one of the experts within the Mozilla community,
or feel like you have valuable contributions to make
to issues on other specifications even where you haven't explicitly been asked to do so.

The goal of the discussions in this repository is
to figure out what we think about a proposal or specification.
The key factors to consider are:

* how useful we think the proposed feature is likely to be (or how important the use case it's trying to address is), relative to the likely costs to users (e.g., security or privacy risks), developers (e.g., increased complexity and cognitive load), and implementers (cost of implementing it and maintaining that implementation)
* whether there are any critical problems we see in the current proposal that we should try to get fixed (e.g., around security, privacy, or ability to implement across multiple browser engines)

It's useful to discuss these in the relevant issue in this repository.

At the same time,
we should avoid doing things to move
discussions that should happen in the standards body's normal discussion mechanisms
from happening instead in the standards-positions issue.
When it makes sense to do so,
it's good to raise issues through the normal issue trackers for the proposal.
However, when doing so, it's worth being careful to avoid giving a *mistaken* impression
that engagement in the discussion constitutes support.
In some cases, avoiding this impression may require having some of the discussion in the standards-positions issue.
However, in many cases that can be avoided
by giving appropriate context when filing issues, such as:
"I was reading [specification] in order to understand it better
to help evaluate what Mozilla thinks of it,
and while doing that I noticed ..."

Members of the Mozilla community are
welcome to judge that we've come to sufficient consensus in the issue,
and make a pull request to document that consensus by changing `activities.json`.
When this happens, we'd like to try to keep the technical discussion
about what the position is
happening in the issue
(so that it stays in one place),
and limit the discussion in the pull request
to the details of making the change to `activities.json`.

0 comments on commit 1354cbd

Please sign in to comment.