Details
-
Task
-
Status: Closed
-
Major
-
Resolution: Fixed
-
2.0.0-alpha-1
-
None
-
Reviewed
Description
Following on from Andrew's JIRA year-end cleaning spree, lets get some guidelines on filing issues e.g. fill out all pertinent fields, add context and provenance, add value (i.e. triage), don't file issues that are nought but repeat of info available elsewhere (build box or mailing list), be reluctant filing issues that don't have a resource behind them, don't file issues on behalf of others, don't split fixes across multiple issues (because there are poor folks coming behind us trying to backport our mess and piecemeal makes their jobs harder), and so on.
The guidelines are not meant to put a chill on the opening of issues when problems are found, especially not for new contributors. They are more meant for quoting to veteran contributors who continue to file issues in violation of what was thought a common understanding; rather than explain each time why an issue has been marked invalid, it would be better if we can quote chapter and verse from the refguide.
Dump any suggestion in here and I'll wind them up as a patch that I'll run by dev mailing list to get consensus before committing.
Here is a running google doc if you'd like to add comment: https://docs.google.com/document/d/1p3ArVLcnQnifk6ZsF635qWBhMmfTUJsISyK15DXnam0/edit?usp=sharing