Before reporting a bug try first reverting to defaults
A bug report should contain these 4 things:
Steps to reproduce: You should give detailed steps on how someone can reproduce the problem.
Expected result: It’s important to include the result you’re expecting, as it might differ from how the program was designed to work.
Actual result: This is also important, since it’s possible that following your steps on a different system doesn’t reproduce the issue.
Environment: This would be OS version, version of TextMate, the language you are working in, and other possibly relevant information. (For example, if you’re seeing graphics artifacts and you’re on a retina MacBook Pro, you should include that.)
See this great article (by Jakob Nielsen) on writing headlines, page titles, and subject lines.
As they say, a picture is worth a thousand words, but that is not what we want in a succinct bug report! Not to mention the plethora of other issues related to submitting bug reports as images.
So only include pictures or movies as extra material when it clarifies the bug report in ways that cannot be expressed in text, for example if text is garbled, it is useful to include an image of how exactly it gets garbled.
Opening an issue saying “syntax highlight is incorrect” with nothing besides a screenshot is not acceptable.
Unless you have steps to reproduce, there’s generally no need to report a crash. We already get crash reports from users who haven’t opted out.
You can change this in Preferences → Software Update.
If you’re opening an issue about TextMate crashes, please include the corresponding crash report.
You can find a list of submitted reports in Notification Center; just click the entry to open an online version. This also provides you with a URL to include in the issue (please do!).
You can also find crash reports for your system online under my crashes.
Hangs are different than crashes. If the program locks up, you should find (or create) a “spin report”. These are normally found here:
If you need to generate a spin report while TextMate is locked up, here’s how :
Last edited by Allan Odgaard,