Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
This page is part of a series on how you can take part in the MyPaint project
Sometimes a user support request comes in without very much substantive information in it, despite our best efforts to educate people about what makes a good bug report! These reports can be maddeningly vague, but should be dealt with as carefully as reports When handling these,
- Thank the reporter for reporting the issue.
- Gently point them at the bug reporting guidelines.
- Be kind. Remember the user may not be technically inclined, and that this may be the first report they make. We'd like every user to get involved, and not to be discouraged.
- Be honest. We may not be able to help every installation, but tell them that's a possibility. Provide pointers to other forums which may be more helpful.
- Encourage detail, especially about versions and build information.
- No jargon.
- Write simply, at a level comprehensible to a 12 to 14 year old. Use the conventions and tools described in our writing guide.
- Consider making FAQ entries as a result of the conversation.
- Discourage thread drift, encourage anyone who chimes in with anything not confirmed as related to make new issues.
- Triage notes are great as summaries of what's been going on, but they are blunt tools. Take care to keep them separate from replies, and try not to discourage the reporter.
Triagers and other project members now have access to a number of saved texts in Github.
Needs More Info - looks like a
bugbut there's too little information to allow it to be confirmed or reproduced. Issue should probably be tagged
User Support Request - if it's a straight-up user support request, our initial goal is to point the reporter at better sources of information and close the report fairly quickly. The issue should probably be labelled
user-supporttoo. Sometimes issues in this state turn out to be
enhancementrequests in disguise though.
- There is also a
(triage note)version, which is a bit stuffier and less friendly, but clearer that the issue tracker is the wrong forum. Don't use it by itself, use the fluffy version too
- There is also a
Piggybacked Issue - these are multiple sub-issues in one big ball of yarn. Reporters should be strongly discouraged from bundling multiple reports together.
- Try to disentangle the report into its main areas.
- Link the reporter to existing issue threads that look relevant.
- If it has just one clear main topic that doesn't have its own issue yet and all the other sub-issues look like duplicates, retitle it and let it become the main report.
- Otherwise, close the issue, and tag it as
duplicateif any of the sub-issues look like duplicates.