Kodi Community Forum

Full Version: GitHub issues guide
You're currently viewing a stripped down version of our content. View the full version with proper formatting.
I've been following the new GitHub Issues feature the team have been using and it is a fantastic improvement. Already some great fixes produced and bugs identified. I also see Microsoft announced they are working with GitHub to prioritise new features for this as well so hopefully some improvements on the way in terms of filtering, search and templates soon.

Anyway I also see developers replying to first line support requests(not an easy job), so here is some advice from someone who has worked in 1st line support for many years... Wink

- Always thank the user for taking the time to report a problem. You would be amazed how far this goes to getting good bug reports.
- Politely advise them if they have not completed the bug reporting template to satisfaction. Using the wording "please", "if possible" is what I mean by being polite.
- Assign an owner to the report as soon as possible, even if they are going to close it or cant help. Ownership is important for quickly resolving things and good organisation.
- Use category tags for reports even if invalid.
- If you close a request tell the submitter why and crucially ask them to fix the missing information if that is what is required.
- Arguing or flaming reporters is utterly pointless, guide them in the direction or don't reply at all. If they are rude (and some will surely be) don't be rude back.
- Its always worth remembering that users who make it past the GitHub barrier probably don't use it, and we all started somewhere once so worth giving them a helping hand.
- Celebrate fixes!

Hopefully this makes the process a friendly and effective place to fix bugs and issues.
And for users submitting issues:

- Always fill in the template with all required information
- Always submit a debug log
- Don't bump your thread if you don't get a response.
- Make sure you are running Kodi without Add-ons or custom skins when submitting the report
- Be polite and courteous in your replies, Kodi is open source and nobody is getting paid to do this
- If a developer asks for more information or for you to try a new build be ready to do just that
- Screenshots or videos can be hugely helpful in some reports (small tip but you can drag and drop any image onto a github issue text box)
- Make sure the platform you are running Kodi on is specified

Helpful Links