[Laszlo-dev] tips on bug reporting

[Benjamin Shine]

A few constructive comments on bug filing -- these mostly have to do  
with that bug descriptions are often truncated in our communications  
techniques, so it's important to get the core of it in the first part  
of the summary.

- Please describe the problem in the summary, without reference to  
the browser/OS, unless the problem is known/suspected to be specific  
to a particular browser/OS.
- Even if a problem is specific to a particular platform, please put  
the problem description first in the bug summary, followed by the  
most important part of the environment.
- Try to list the *problem* part of the issue at the very beginning  
of the summary

...so the bug summary of LPP-4878 that you created would be easier to  
deal with as something like...
LZPIX Icons not drawn attached to the pointer when dragging multiple  
pictures from photo pane to clips

although actually the vocabulary that we use for LzPix -- which  
you'll pick up, don't worry about it --
is "thumbnails" and "cursor" and "grid" rather than "icons" and  
"pointer" and "photo pane".

Moving on to the description:
If you later can clarify the description, as you did in the comment  
below, it is preferable to edit the description rather than add a  
comment, especially if work on the bug has not begun yet. We want the  
description to have a complete and correct (ahem) description of the  
bug; comments can track the progress of the bug, not change the  
description. If a comment would change the bug description a lot, it  
probably needs to be a separate bug.

-ben


Begin forwarded message:

> From: "Steve O'Sullivan (JIRA)" <jira at laszlosystems.com>
> Date: October 11, 2007 11:03:21 AM PDT
> To: ben at laszlosystems.com
> Subject: [JIRA] Commented: (LPP-4878) LZPix, SWF7 FireFox 2.0.0.7  
> WXP SP2: Select multiple pictures in photo pane and drag to clips,  
> icons may not be drawn attached to the pointer
>
> Issue (View Online)
>
> Key: LPP-4878
> Issue Type:   Bug
> Status:   New
> Priority:   --
> Assignee: Benjamin Shine
> Reporter: Steve O'Sullivan
> Environment: SWF7
> FireFox 2.0.0.7
> WXP SP2
> OSX 10.4.10
> Operations
>
>  View all
>  View comments
>  View history
>
> LZPix, SWF7 FireFox 2.0.0.7 WXP SP2: Select multiple pictures in  
> photo pane and drag to clips, icons may not be drawn attached to   
> the pointer
> Updated: 11/Oct/07 11:03 AM   Created: 11/Oct/07 10:50 AM
> The following comment has been added to this issue:[ Permlink ]
> Author: Steve O'Sullivan
> Date: 11/Oct/07 11:03 AM
> Comment:
> Small icon group IS drawn directly under the pointer when moving a  
> group of fifteen pictures, irrespective of click location in target  
> picture.
>
>
> Project:OpenLaszlo
> Components: SA - LZPIX
> Affects Versions: WaffleCone
>
>  Description
> LZPix, SWF7 FireFox 2.0.0.7 WXP SP2: Select multiple pictures in  
> photo pane and drag to clips, icons may not be drawn attached to   
> the pointer
>
> Expected behavior: I expect that when I click on a group of   
> selected photos, the mini icons that represent the group will be   
> drawn attached to the pointer.
>
> However, depending upon where you click in the target photo of the  
> group (upper left hand corner of the pic versus the lower right   
> hand corner,say) the small icon group may be drawn up and to the   
> left of the pointer by as much as an inch. Can be a little   
> confusing to me.
>
> Found in build 6775. Reproduced in Firefox in Mac and Windows
>
>
> This message was automatically generated by Atlassian JIRA  
> Enterprise Edition, Version: 3.6.5-161 - Bug/feature request.
> If you think it was sent incorrectly, contact one of this server's  
> administrators.
>