Tips for writing a good bug report

An RSS/Atom newsreader with features comparable to commercial newsreaders.
Post Reply
jeff_johnson_dev
Cocoaforge Admin
Posts: 1385
Joined: Wed Mar 01, 2006 9:12 pm

Tips for writing a good bug report

Post by jeff_johnson_dev »

Dear Vienna users,
Thanks for reporting bugs here in the Vienna General forums! We are eager to hear about and fix any bugs that you discover in Vienna. With that in mind, I'm offering some tips to help you write a good bug report.

The Goal:
The goal of a good bug report is to explain to us, the developers, how to reproduce the bug on our own computers. If we cannot reproduce the bug ourselves, then it is very difficult for us to fix it. Therefore, please be as detailed and specific as possible. Sometimes it is the tiniest detail that is the key to isolating the bug.

Crashlogs can be attached to messages. They must be zipped though, because the message board will reject .crash or .crashlog files.

Questions:
This is a list of some of the questions we will want to ask you about the bug, so it would be very helpful if the questions are already answered in your initial bug report.
  1. Versions. What version of Vienna and Mac OS X are you currently using? Also, have you used any earlier versions of Vienna, and did the bug exist in earlier versions?
  2. Bug Description. What is the bug, and how exactly did it occur. Please describe in as much detail as possible so that we can try to reproduce it. Tell us what you were doing when the bug occurred. Numbered steps to produce the problem would be very helpful. Be specific about what areas of Vienna's interface were involved (the folders list, the articles list, the article viewing pane, web browser tabs, etc.).
  3. URLs. If the bug involves one or more subscriptions, then please give us the URLs for the subscriptions. If the bug involves a web site in a tab, please give us the URL of the web site.
  4. Settings. What are your preferences and settings in Vienna? We probably don't need to know everything, but try to give us the relevant ones. For example, if you're having problems with refreshing, what are your preferences for checking for new articles and for marking the current article read? If you're having display problems, which layout are you using (Report, Unified, Condensed), and which style are you using? If you're having problems launching Vienna, what are your preferences for checking for new articles and for new versions of Vienna on startup?
Posting the report:
Please post the bug report in the Vienna General forums. The developers monitor this forum (by subscribing to its feed in Vienna, of course!), so we will see your post. (The Vienna Developers forum is not for bug reports or feature requests but only for developer discussion.) Please put each bug in its own post, separate from feature requests or other bugs. This makes it easier for us to track the bug and to discuss the bug with users in the forums.



Thanks!
barijaona
Vienna Team
Posts: 661
Joined: Sat Nov 12, 2011 11:10 am
Contact:

Re: Tips for writing a good bug report

Post by barijaona »

Bugs can be reported in this forum, but feature requests should be posted at Github.
Please verify that there is no similar issue already opened before creating a new one.
I contribute to Vienna RSS as a developer.
Please, don't forget those tips for writing a good bug report
User avatar
weriusaa
Latté
Posts: 79
Joined: Mon Dec 03, 2007 9:11 pm

Re: Tips for writing a good bug report

Post by weriusaa »

Thanks a lot for the explanation. Very often I have difficulty writing academic texts, although I have extensive experience and write such texts very often. For now, I plan to ask for help from a service that writes best dissertations, which will allow me to complete one section of my dissertation.
Post Reply