Opening / resolving issues more effectively
Nobody has claimed this yet.
- Dominant language
- HTML
- Stars
- 84
- Forks
- 69
- Avg merge
- 14h 52m
- Merged PRs (30d)
- 2
Description
@rachelcomerford made a great comment as to how to manage issues more effectively (https://github.com/w3c/wg-effectiveness/issues/50). Suggest these are added to /guide:
One the major struggles that we face in the groups I participate in is in getting productive responses to issues. Too often I see thinly disguised sarcasm, personal complaints that are unrelated to finding a solution, or a long list of reasons why something won't work without any proposed solutions. In problem solving, I try to ask participants to answer the following questions:
What problem are you trying to solve?
What solution are you proposing?
Why do you believe this is the ideal solution?
What alternatives did you consider
What is your back up plan?
Consistency in enforcing these structured responses is difficult (and I admit to struggling with it) but without this, I see newer members to groups and in particular newer members to the W3C/W3C processes alienated by lack of explanation of methods, uninterpretable proposals, and (in my opinion the worst offense) the attitude that can sometimes accompany experience.
While it will be difficult to convince some member to abide by guidelines like this, I think it would be a beneficial structure (or something like it would be) to recommend in order to help keep github conversations civil and effective.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Review the /guide location and the linked W3C discussion to understand how guidance is organized and how this proposal should fit. Add clear recommendations for structured, civil issue responses covering the questions listed in the issue; done means the guidance is included in the guide and is consistent with its existing style.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100