Difference between revisions of "HowTo:Make A Bug Report"
Jump to navigation
Jump to search
(Updating this section for github issues over our older FlySpray issue tracker.) |
|||
| Line 1: | Line 1: | ||
===== Reporting bugs in POV-Ray ===== | ===== Reporting bugs in POV-Ray ===== | ||
| − | Bug reports are an essential part of development, and the developers need you to let them know about programming defects in POV-Ray. However, there are a few things that you need to keep in mind when you are thinking about submitting a bug report or requesting a new feature. Please take a few moments to read this brief list of guidelines ''before'' you open a new task in our [http://bugs.povray.org/ Bug Reporting System]. | + | <p>Bug reports are an essential part of development, and the developers need you to let them know about programming defects in POV-Ray. However, there are a few things that you need to keep in mind when you are thinking about submitting a bug report or requesting a new feature. Please take a few moments to read this brief list of guidelines ''before'' you open a new task in our [https://github.com/POV-Ray/povray/issues Github Issue Tracking System].</p> |
| + | |||
| + | <p class="Note"><strong>Note:</strong> We are in the process of porting issues still open in our previous [http://bugs.povray.org/ FlySpray Bug Reporting System] to the new | ||
| + | [https://github.com/POV-Ray/povray/issues Github Issue Tracking System]. During this transition it is necessary to review <em>both</em> systems to know if an issues has already been made known to the developers. Please open all <em>new</em> issues in the [https://github.com/POV-Ray/povray/issues Github Issue Tracking System]. If a FlySpray issue is marked as 'tracked on github' please make any further comments or updates on github.</p> | ||
===== Guidelines for opening new tasks ===== | ===== Guidelines for opening new tasks ===== | ||
| Line 7: | Line 10: | ||
* We cannot accept bug reports for modified versions of POV-Ray. | * We cannot accept bug reports for modified versions of POV-Ray. | ||
* In almost all cases where a rendering bug is being reported, we require a minimal sample scene causing the bug be submitted, as well as an image showing the problem. | * In almost all cases where a rendering bug is being reported, we require a minimal sample scene causing the bug be submitted, as well as an image showing the problem. | ||
| − | * Always perform a search on '''both open and closed''' | + | * Always perform a search on '''both open and closed''' 'issues' or 'tasks' before opening a new one. Your bug might already have been reported, or your feature requested. |
* Use the English language in any tasks you open. Nothing will get done if we can't understand you. | * Use the English language in any tasks you open. Nothing will get done if we can't understand you. | ||
* Only report one bug or request one feature per task. | * Only report one bug or request one feature per task. | ||
* If you report a bug, and we mark it as 'requires testing', then please test it and add a comment to the task telling us how well it works. | * If you report a bug, and we mark it as 'requires testing', then please test it and add a comment to the task telling us how well it works. | ||
| − | * If a task is closed | + | * If a task is closed as fixed then try the [https://github.com/POV-Ray/povray/releases development version] before requesting that it be re-opened. |
| − | * If we deny your request to re-open a task, check the | + | * If we deny your request to re-open a task, check the history/comments for our reason. If you are unsatisfied with the reason, you are welcome to discuss it in the [http://news.povray.org/ forums]. |
* Be polite. Remember that you got POV-Ray for free. | * Be polite. Remember that you got POV-Ray for free. | ||
===== Text formatting tips ===== | ===== Text formatting tips ===== | ||
| − | + | Github allows for a lot more formatting within task descriptions and comments. Here are a few helpful essentials: | |
| − | * To quote some other comment, | + | * To quote some other comment, use the github quote feature after marking the text to be quoted. |
| − | * | + | * To make code, use the mark code feature of github after marking your code. |
| − | * Refer to | + | * Refer to github issues and pull request by number prefixed with # and github will create the link. Please refer to older Flyspray tasks not yet ported by their numeric id preceded by "<tt>FS#</tt>" (e.g. <tt>FS#123</tt>) and perhaps insert the URL for as github will create the corresponding link. |
* Do make use of the preview button. | * Do make use of the preview button. | ||
===== Miscellaneous ===== | ===== Miscellaneous ===== | ||
| − | * To illustrate your bug report or comment with images, please do make use of the "attach | + | * To illustrate your bug report or comment with images, test scenes or zip files, please do make use of the "attach file" functionality, rather than linking to some 3rd party image hosting site. This way the uploaded files will remain accessible as long as the github issue persists. Note when uploading scene related files the POV-Ray extensions of .pov and .inc are not supported; needing an additional .txt suffix before upload. Further .tar and .gz files are '''not''' supported as of this writing, but rather only .zip. |
==See also== | ==See also== | ||
*[[Knowledgebase:POV-Ray Feature Requests]] | *[[Knowledgebase:POV-Ray Feature Requests]] | ||
Revision as of 12:25, 19 November 2016
Reporting bugs in POV-Ray
Bug reports are an essential part of development, and the developers need you to let them know about programming defects in POV-Ray. However, there are a few things that you need to keep in mind when you are thinking about submitting a bug report or requesting a new feature. Please take a few moments to read this brief list of guidelines before you open a new task in our Github Issue Tracking System.
Note: We are in the process of porting issues still open in our previous FlySpray Bug Reporting System to the new Github Issue Tracking System. During this transition it is necessary to review both systems to know if an issues has already been made known to the developers. Please open all new issues in the Github Issue Tracking System. If a FlySpray issue is marked as 'tracked on github' please make any further comments or updates on github.
Guidelines for opening new tasks
- Take some minutes of your time and read this document, it will teach you how to report a bug correctly.
- If you're not sure it's a bug, or how to report it, chat with the folks in the beta-test forum.
- We cannot accept bug reports for modified versions of POV-Ray.
- In almost all cases where a rendering bug is being reported, we require a minimal sample scene causing the bug be submitted, as well as an image showing the problem.
- Always perform a search on both open and closed 'issues' or 'tasks' before opening a new one. Your bug might already have been reported, or your feature requested.
- Use the English language in any tasks you open. Nothing will get done if we can't understand you.
- Only report one bug or request one feature per task.
- If you report a bug, and we mark it as 'requires testing', then please test it and add a comment to the task telling us how well it works.
- If a task is closed as fixed then try the development version before requesting that it be re-opened.
- If we deny your request to re-open a task, check the history/comments for our reason. If you are unsatisfied with the reason, you are welcome to discuss it in the forums.
- Be polite. Remember that you got POV-Ray for free.
Text formatting tips
Github allows for a lot more formatting within task descriptions and comments. Here are a few helpful essentials:
- To quote some other comment, use the github quote feature after marking the text to be quoted.
- To make code, use the mark code feature of github after marking your code.
- Refer to github issues and pull request by number prefixed with # and github will create the link. Please refer to older Flyspray tasks not yet ported by their numeric id preceded by "FS#" (e.g. FS#123) and perhaps insert the URL for as github will create the corresponding link.
- Do make use of the preview button.
Miscellaneous
- To illustrate your bug report or comment with images, test scenes or zip files, please do make use of the "attach file" functionality, rather than linking to some 3rd party image hosting site. This way the uploaded files will remain accessible as long as the github issue persists. Note when uploading scene related files the POV-Ray extensions of .pov and .inc are not supported; needing an additional .txt suffix before upload. Further .tar and .gz files are not supported as of this writing, but rather only .zip.