Please send bug reports via email.
If you’re feeling especially helpful, one additional part is always appreciated:
ADDITIONAL NOTES (OPTIONAL)
Let’s break these down.
A one (or maybe two) sentence, high-level description of the problem. This is almost like the subject line of an email.
This is where you tell the developer about your setup. Three things are vital:
iPhone 5S, or
2013 MacBookPro Retina)
iOS 7.2, or
OS X 10.9.4)
Mail.app Version 7.3 (1878.6), or
TextMate version 2.0-alpha.9551)
If you’re reporting a bug on a website, substitute the name and version of the web browser you are using for the app name and version.
STEPS TO REPRODUCE
This is the most important part. Break the issue down into a specific numbered list of steps that always (or at least sometimes) reproduces the problem.
Seriously, break it down into a numbered list of steps. Here’s an example:
1. Visit example.com in any browser listed in SETUP above. See normal "Home" page appear. 2. Click blue "compose" button. See "compose" text area appear 3. Type "hello world" in compose text area etc…
Sometimes the desired outcome you expect is not obvious to the developer. Just to be safe, spell it out here in one short sentence or phrase.
This is what you’ve been waiting for. Here’s your chance to describe what is actually going wrong. Make this section as long and detailed as you like. In fact, rant away! Since you’ve already provided a numbered list of steps to reproduce the problem (you did provide a numbered list of steps, didn’t you?), you’re now free to complain all you like about what’s going wrong.
If the app crashes, describe that here, and include the entire crash log, please.
And finally, the optional part:
ADDITIONAL NOTES (OPTIONAL)
If you’re feeling especially helpful, fee free to provide additional info here. For example, if you know what version of the app or the OS this issue first appeared in, please mention that here.
If you’re reporting a bug in a website, did you try to reproduce it in multiple browsers? (That’s always a great idea, BTW.) Great! Tell us about it here.
If you’re reporting a bug in a Mac app, did you simultaneously run Console.app and capture some suspicious-looking console logs? (That’s always a great idea, BTW.) Great! Tell us about it here.
SUMMARY ------------------ <REPLACE ME WITH A HIGH-LEVEL DESCRIPTION OF THE PROBLEM IN A SENTENCE OR TWO> SETUP ------------------ Device: <DEVICE + VERSION HERE> OS: <OS + VERSION HERE> App: <APP OR BROWSER + VERSION NUMBER HERE> STEPS TO REPRODUCE ------------------ 1. <STEP ONE> 2. <STEP TWO> 3. <ETC> EXPECTED RESULT ------------------ <WHAT DID YOU EXPECT> ACTUAL RESULT ------------------ <WHAT WENT WRONG> ADDITIONAL NOTES ------------------ <CRASH LOGS, CONSOLE ERROR MESSAGES, VERSION THIS FIRST APPEARED, AND OR OTHER OPTIONAL INFO>