Guideline for creating issues » History » Version 13

Leonid Protasov, 05/20/2014 08:41 PM

1 1 Andreas Smas
h1. Guideline/Rules for creating issues
2 1 Andreas Smas
3 13 Leonid Protasov
* Before reporting a bug be sure you updated to the latest Bleeding Edge version: https://showtimemediacenter.com/downloads/showtime/master
4 10 Leonid Protasov
5 10 Leonid Protasov
* If it's a bug - attach the log: https://showtimemediacenter.com/projects/showtime/wiki/Logging
6 10 Leonid Protasov
7 11 Leonid Protasov
* To create an issue, use: https://showtimemediacenter.com/projects/showtime/issues/new
8 11 Leonid Protasov
9 6 Andreas Smas
* Don't reuse bugs. If a bug has been closed and it's not the *exact same* issue, file a new bug.
10 6 Andreas Smas
11 3 Andreas Smas
* Don't create duplicate bugs. At least try to skim the list before posting a new one.
12 3 Andreas Smas
13 2 Andreas Smas
* For bugs: Always write the version where the bug is found. There is a specific field for that. This does not apply for features.
14 1 Andreas Smas
15 12 Leonid Protasov
* Don't write multiple bugs/feature requests, etc in one single issue. It's harder to discuss and know when things are done.
16 1 Andreas Smas
17 8 Andreas Smas
* Unless you know that the bug is a regression (ie, something that worked fine in a previous version of Showtime), please try using the latest version of Showtime before filing the bug. The official versions are found "here":https://www.lonelycoder.com/showtime/download. If you are using your own builds or builds from somewhere else you better be sure what you are doing.
18 4 Andreas Smas
19 1 Andreas Smas
* If a file is unplayable for whatever reason you must attach a sample of it or it is almost impossible for me to figure out what's wrong.
20 1 Andreas Smas
21 5 Andreas Smas
* If the sample file is bigger than > 500 MB (it usually is for movies) the file can just be cut into pieces. 50Mb should be enough. This does not work for all fileformats  but for AVI and MKV it should work fine.
22 1 Andreas Smas
** On Windows use this tool: http://www.filesplitter.org/
23 1 Andreas Smas
** On Linux use the *dd* command: @dd if=<originalfile> of=cut.mkv bs=1000000 [email protected] to generate a 50MB file
24 5 Andreas Smas
25 5 Andreas Smas
* If you are worried about attaching sensitive material to a ticket, make the ticket private (available when the ticket is created). By doing so only a small set of trusted developers (currently two people) will be able to access the contents.
26 1 Andreas Smas
27 9 Leonid Protasov
Failure to comply with these (simple) rules will result in the issue being rejected. If you think that's unfair for me to impose these rules consider the amount of time I've spend on the project so far. Badly written tickets will just consume more of my time that I could spend on new features instead.
28 1 Andreas Smas
29 1 Andreas Smas
Thank you for understanding,
30 1 Andreas Smas
Andreas