Guideline for creating issues » History » Version 10

Leonid Protasov, 02/17/2014 05:45 PM

1 1 Andreas Smas
h1. Guideline/Rules for creating issues
2 1 Andreas Smas
3 10 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 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.
8 6 Andreas Smas
9 3 Andreas Smas
* Don't create duplicate bugs. At least try to skim the list before posting a new one.
10 3 Andreas Smas
11 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.
12 1 Andreas Smas
13 1 Andreas Smas
* Don't write multiple bugs/feature requests, etc in one single ticket. It's harder to discuss and know when things are done.
14 1 Andreas Smas
15 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.
16 4 Andreas Smas
17 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.
18 1 Andreas Smas
19 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.
20 1 Andreas Smas
** On Windows use this tool: http://www.filesplitter.org/
21 1 Andreas Smas
** On Linux use the *dd* command: @dd if=<originalfile> of=cut.mkv bs=1000000 [email protected] to generate a 50MB file
22 5 Andreas Smas
23 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.
24 1 Andreas Smas
25 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.
26 1 Andreas Smas
27 1 Andreas Smas
Thank you for understanding,
28 1 Andreas Smas
Andreas