w3c / w3c/guide

[documentreview] Document the process for handling review comments at transitions

Open
#274 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
HTML
Stars
84
Forks
69
Avg merge
14h 52m
Merged PRs (30d)
2

Description

From @nigelmegitt (originally at https://github.com/w3c/Guide/issues/276):

As a general point, as per w3c/w3process#130 it would be good to document the process for handling review comments, and what kinds of responses are likely to result in a transition request being declined.

For example, if a responder says "I don't like the colour of the text in this document" and the WG ignores the comment, not even sending a response, is that okay? Or at the other end of the scale, if a commenter raises a detailed technical point, the WG considers and responds, and then the commenter remains unhappy with that response, is that okay?

What level of tracking of responses is required and what is merely good practice?

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading the guidance referenced in w3c/w3process#130 and the original discussion at w3c/Guide#276. Define the expected handling, response, and tracking requirements for review comments, including when a transition request may be declined. Done means the process and examples are documented clearly enough to answer the questions raised here.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.