Following are guidlines for a good bug report. They help to convey your experience to the developers efficiently. A good bug report saves time, because we don't have to ask for missing information and we can easily reproduce what's going on. Therefore we can better and faster provide a fix.
Please take the time to write a good bug report. In the end, everybody will be happier :) you because you'll get the fix sooner and us because we don't have to guess wildly what the report means and why it happens.
Summary of rules for a good bug report:
Some bugs may already be resolved meanwhile. To determine whether the bug is a new one or an known one, the version in the about dialog (revision in brackets) is helpful.
Some bugs are only present on some operating systems, hence it is important to know on which one to look.
Short descriptions of faulty behaviour is often ambigious. Please be as precise as possible.
If the case is more complex, do a step by step description of your actions. Additionally, please attach a minimal example .tex file if applicable.
Screenshots do significantly help to demonstrate what you are talking about, if possible add one. Nevertheless mark or describe clearly what is faulty. Especially with non-latin fonts, errors are not easily discernable for the developers.
In case of a crash, please attach the backtrace which can be found in the tmp-directory. The backtrace file is called
Sometimes a faulty behavior is not obvious or the program just works differently from the users expectations. Therefore you should specify what you think should happen.
This is a good example:
OS X Yosemite 10.10.1 TeXstudio 2.8.8 The width of tabs for the "Messages / Log Files" does not adapt to the font size. How to reproduce: Go to Preferences -> Font size and set the font size 10 or more Result: The font in the tabs is increased, but the tab width is not. Thus the text is clipped. Expected: Tabs should scale with the font size. [screenshot]