Difference between revisions of "How to report bugs"

From dmfswiki
Jump to: navigation, search
(Created page with "If something doesn't work as expected there can be several reasons: * The feature has not been implemented yet. * There is a bug in the app. * There is a bug in your server softw...")
 
 
Line 20: Line 20:
 
#* A brief description what you would expect instead.
 
#* A brief description what you would expect instead.
 
# A log
 
# A log
#* Also be sure to include a log from your phone if possible. See [[How to capture a log with CatLog]] to learn how you can capture a log with [https://market.android.com/details?id=com.nolanlawson.logcat&feature=search_result CatLog], an excellent log reader.
+
#* Also be sure to include a log from your phone if possible. See [[How to capture a log]] for reference.
 
# Test data
 
# Test data
 
#* Please append test data that leads to the problem if possible. Of course you can blank out any personal data. To do so replace them by x, do not remove entire lines if possible.
 
#* Please append test data that leads to the problem if possible. Of course you can blank out any personal data. To do so replace them by x, do not remove entire lines if possible.
  
 
Especially if you use a server that is not yet on the list of [[Supported servers & services]] it would be very helpful if you can provide a test account on your server.
 
Especially if you use a server that is not yet on the list of [[Supported servers & services]] it would be very helpful if you can provide a test account on your server.

Latest revision as of 08:38, 24 September 2014

If something doesn't work as expected there can be several reasons:

  • The feature has not been implemented yet.
  • There is a bug in the app.
  • There is a bug in your server software.
  • Your phone's manufacturer has changed something that is incompatible with stock android (see Android fragmentation for details).

Except for the first case, a detailed bug report is important to me to fix it. It's not always possible to reproduce a problem especially if it requires specific server software or a specific device. Please send the report via email to the address on my website.

Things a detailed log report should contain

  1. Preconditions
    • Your phone model.
    • The server you're using (and its version number).
    • If applicable: the client software you're using on other clients like your desktop pc.
  2. Steps to reproduce the problem
    • What have you done when the problem occurred?
    • What exactly happened (Was there an error message? What did it say?).
    • Does it always happen when you do that?
  3. Expected behaviour
    • A brief description what you would expect instead.
  4. A log
  5. Test data
    • Please append test data that leads to the problem if possible. Of course you can blank out any personal data. To do so replace them by x, do not remove entire lines if possible.

Especially if you use a server that is not yet on the list of Supported servers & services it would be very helpful if you can provide a test account on your server.