Info: Better bug reporting

Contains tips for configurators working with Aware IM
Post Reply
hpl123
Posts: 2579
Joined: Fri Feb 01, 2013 1:13 pm
Location: Scandinavia

Info: Better bug reporting

Post by hpl123 »

Hi all,
Here is some information and a request of sorts to ask everyone to become better at reporting bugs. I have to be honest, I hadn´t even looked at the guidelines for bug reporting until today ( :oops: ) and I´m sure many haven´t :). In the official guidelines I saw an link to a debug screenshot tool called Debugmode Wink and this tool is actually really useful and deadsimple to use + it actually is quicker to produce a bug report in Wink than most other ways like trying to explain in words, take screenshots of your own that you have to explain etc. etc.. Here is the link to download wink:
http://www.debugmode.com/wink/download.htm

I will start using Wink for all my bug reports from today and I recommend you to do the same. As support also points out in the official guidelines, the clearer and better bug report you produce, the higher the probability is that it will be fixed and fixed quickly. Here are my recommended steps for bug reporting and I have also added the official guidelines written by support underneath the recommended steps:

Recommended steps:

1. Use Wink to take multiple screenshots of the bug (screenshots are best because screencasts like video with audio etc. is not possible from servers, vps´s etc.)
2. Add annotations and next buttons to your screenshots
3. Ideally and when possible prepare a sample BSV
4. Render your Wink bug report (will produce swf, html, js files)
5. Zip the bug report files together with the sample bsv
6. Write reference post in forum problem reports section (simple "FYI" post)
7. Send zipped bugreport to [email protected]


Official guidelines:

Dear Aware IM Users,
before posting a new topic please search the forum and check that the issue has not been posted before. Please also check that the issue has not been mentioned in the Appendix B of the Aware IM User Guide. When posting indicate the build number of your Aware IM version.

The best way to report a bug is to describe the steps required to reproduce the problem:
1. Do this
2. Do that
3. Problem - describe the problem. Send your BSV file to [email protected] if applicable.

Even better way of reporting a problem is to do a screencast demonstrating the problem. You can use this free software http://www.debugmode.com/wink/ to create screencasts.

The better the problem is described the higher the chance that it will be fixed quickly.
Thank you for your cooperation.


Thanks and support or developers, please comment if I have missed something etc. etc.
Henrik (V8 Developer Ed. - Windows)
hpl123
Posts: 2579
Joined: Fri Feb 01, 2013 1:13 pm
Location: Scandinavia

Re: Info: Better bug reporting

Post by hpl123 »

Forgot to add, include the OS you´re on and the Aware IM version and build number you´re using.
Henrik (V8 Developer Ed. - Windows)
hpl123
Posts: 2579
Joined: Fri Feb 01, 2013 1:13 pm
Location: Scandinavia

Re: Info: Better bug reporting

Post by hpl123 »

Revised version, forgot something else:

Recommended steps:

1. Use Wink to take multiple screenshots of the bug (screenshots are best because screencasts like video with audio etc. is not possible from servers, vps´s etc.)
2. Add annotations and next buttons to your screenshots
3. Ideally and when possible prepare a sample BSV + write steps to reproduce
4. Render your Wink bug report (will produce swf, html, js files)
5. Zip the bug report files together with the sample bsv
6. Write reference post in forum problem reports section (simple "FYI" post)
7. Send zipped bugreport to [email protected] together with OS, Aware IM version/build number
Henrik (V8 Developer Ed. - Windows)
tford
Posts: 4238
Joined: Sat Mar 10, 2007 6:44 pm

Re: Info: Better bug reporting

Post by tford »

I will tell you from personal experience in 8 years using AwareIM, the clarity of your bug report will directly impact the speed of the bug exploration & fix by support.

In all my experience with systems development over the years, I have never seen an organization that is as methodical and quick about bug fixes as AwareIM once they are properly documented and reported.
Tom - V8.8 build 3137 - MySql / PostGres
customaware
Posts: 2391
Joined: Mon Jul 02, 2012 12:24 am
Location: Ulaanbaatar, Mongolia

Re: Info: Better bug reporting

Post by customaware »

I'll Second that Tom.

Best Support I have EVER experienced.

It is so refreshing to find a company that actually listens and supports it's developers so well.
Cheers,
Mark
_________________
AwareIM 6.0, 8.7, 8.8, 9.0 , MariaDB, Windows 10, Ubuntu Linux. Theme: Default, Browser: Arc
Upcloud, Obsidian....
Image
hpl123
Posts: 2579
Joined: Fri Feb 01, 2013 1:13 pm
Location: Scandinavia

Re: Info: Better bug reporting

Post by hpl123 »

Can only agree guys, KUDOS support!
Henrik (V8 Developer Ed. - Windows)
hpl123
Posts: 2579
Joined: Fri Feb 01, 2013 1:13 pm
Location: Scandinavia

Re: Info: Better bug reporting

Post by hpl123 »

Update.
Got feedback from support regarding bug reports made via the recommended steps above (using Wink). These reports should only be done when the bug or problem is a difficult one or one that needs specific information to understand the bug (too much hassle/work otherwise). Here is therefore 2 new different recommended steps for better bug reports:

1. Basic bug (most bugs fall into this category):
1. Write an explanation of the bug in an email.
2. Ideally and when applicable, create a sample bsv and configure / prepare the bsv so it automatically populates the app when opened i.e. support log on and the app initialise itself with the bug shown in the main (or other) frame.
3. Write a step by step guide (in the email) for support to follow to reproduce the bug. Also include OS and Aware IM version/build in email.
4. Write reference post in forum problem reports section (simple "FYI" post).
5. Send email / bugreport to [email protected].


2. Complex bug (difficult to understand where more visual explanation is needed etc.):
1. Use Wink to take multiple screenshots of the bug (screenshots are best because screencasts like video with audio etc. is not possible from servers, vps´s etc.)
2. Add annotations and next buttons to your screenshots
3. Ideally and when possible prepare a sample BSV + write steps to reproduce
4. Render your Wink bug report (will produce swf, html, js files)
5. Zip the bug report files together with the sample bsv
6. Write reference post in forum problem reports section (simple "FYI" post)
7. Send zipped bugreport to [email protected] together with OS, Aware IM version/build number
Henrik (V8 Developer Ed. - Windows)
BobK
Posts: 544
Joined: Thu Jan 31, 2008 2:14 pm
Location: Cincinnati, Ohio, USA

Re: Info: Better bug reporting

Post by BobK »

a new version of wink https://www.debugmode.com/wink/ was recently released.
Bob
Post Reply