• All submissions to this site are governed by Second Life Project Contribution Agreement. By submitting patches and other information using this site, you acknowledge that you have read, understood, and agreed to those terms.
Issue Details (XML | Word | Printable)

Key: WEB-194
Type: New Feature New Feature
Status: Resolved Resolved
Resolution: Fixed
Priority: Major Major
Assignee: Torley Linden
Reporter: Celierra Darling
Votes: 8
Watchers: 1
Operations

If you were logged in you would be able to see more operations.
3. Second Life Website - WEB

Streamline and clarify JIRA reporting process for non-technical users

Created: 30/Jun/07 07:19 PM   Updated: 24/Nov/08 04:44 PM
Return to search
Component/s: jira.secondlife.com
Affects Version/s: None
Fix Version/s: None

Issue Links:
Relates

Last Triaged: 23/Sep/08 06:22 PM

Sub-Tasks  All   Open   
 Sub-Task Progress: 

 Description  « Hide
A comment in VWR-46 led to a realization that JIRA is built by programmers for programmers, and is not built with bug reporting by the general public in mind. Since the reporters are already frustrated enough by the bug, I figure that it's a good thing to remove as many of the hoops in their way as possible.

These are a bunch of (probably small) suggestions (subtasks?) that I think might help non-technical people have an easier time submitting a bug report. Feel free to strike things that are very nontrivial.

==Dashboard/Home Page==
Have the default dashboard be one for basic, non-technical users. Move the huge list of filters and the Project Reports things (i.e. things not applicable to a basic user) to a second dashboard - those who want the advanced display to be their default can move the second dashboard up to the first position on their "Manage Portal" page.

Have brief instructions right in the introduction, instead of immediately sending people off-JIRA. Preferably include a list of steps, screenshots, common caveats, etc. If necessary, to utilize the whole screen width, one can leave the right column of the dashboard blank.
Some example text:

If you are looking for one-on-one or urgent help, please go to http://support.secondlife.com and use one of the other support options there.
If you want to file a bug report:
1) If the bug might be related to security, you probably should not file it here. See http://wiki.secondlife.com/wiki/Security_issues for more details.
2) Search for existing reports using the "quick search" box in the upper-right corner. If you find one, you can help by voting for it or commenting on it. For searching tips, see https://wiki.secondlife.com/wiki/Issue_tracker#Searching .
3) If you don't find an existing report for your problem/suggestion, select "Create New Issue" at the top of the screen
4) Select the category that your submission is about. See https://wiki.secondlife.com/wiki/Issue_tracker#Projects_and_Components
etc...
After you submit a bug:
1) You can invite people to add details, refine reproductions, verify information, and vote on the issue. Issues with large numbers of votes and better information tend to get attention sooner.
2) Once the bug is recognized, it will be "imported" (copied to our internal system), marked as in progress, and assigned to a Linden (or WorkingOnIt Linden). If there is a problem with the bug, it will be marked "resolved"...
3) If applicable, once a fix is ready (but not yet released) the bug will be marked "Resolved" and "Fixed Internally". This means that the fix is waiting for a release.
4) Once the bug is released, it should become "Resolved" and "Fixed". To confirm that it has been fixed, you can "close" the bug.
...

Make the Search box more prominent, such as providing a second one somewhere in the content area of the dashboard (if this is an easy change).

If it is easy to do so, make a search box on the default dashboard that searches only unresolved bugs, and another that searches only unresolved new features. Perhaps even have searches for each project (VWR/SVC/WEB/MISC).

==Bug Reporting==
Rename "Linden Lab Issue ID" to "LL Tracking #" or something similar, to make it less likely to be mistaken for a support ticket number. And/or, change the text below the field to something like "For Linden Lab staff use. Any support ticket numbers should go in the description, instead."

Rename "Environment" to "System Information" (so it's not taken to be in-world location).

Change the text under "Environment" to mention the hardware info in the "About" dialog. Perhaps make it vertically larger, depending on how much detail is desired here. Perhaps specifically mention video card and driver version for any graphical glitches or crashes.

There should probably be text under the description field asking for steps to reproduce the problem, if applicable.

The description under "Source Version" is vague... (i.e. is this supposed to be the version against which the patch is made? Is it only applicable if you attach a patch?)

==Issue Management==
Maybe make the comment box at the bottom of the page shown by default.

Remove the "clone" option (WEB-76).

If it is an easy change, rename "resolved" to something like "replied" or "responded", since people take "resolved" to mean something like "the problem is completely fixed" (which would be the "Closed" status). A lot of people seem to get offended because of the misunderstanding.
...perhaps, also rename both "Open" and "Reopened" to "Waiting for LL response".

___
Thanks for making it through all these.



 All   Comments   Change History      Sort Order: Ascending order - Click to sort in descending order
Montana Corleone added a comment - 09/Jul/07 01:49 AM
Nice idea. But really, it needs to be simple, and use standard terminology that a non-geek user is used to.

Plain simple search box on the front page that searches all, rather than trying to wok out if what you think is service is really miscellaneous or viewer. If a user is frustrated, it's because something doesn't work.

So all problem descriptions need to be less geeky.

You should use more standard stuff like Known bug, Workaround, Not yet fixed, feature request etc, and maybe have a scrolling window with new known and work around issues, so that is there is such a workaround people can find it quickly, or double click and vote easily.

It would have been nice to have had some consistency between reporting here and the inworld bug reports, the categories are totally different.

Think about having a geek subject flag, so minor geeky stuff that most people don't understand don't get included unless via checkbox. To a non geek with a problem, everything is critical and high priority lol

You basically need a very simple front end, and a complex one for those that know what they are doing. Use prefs or cookies to set up. If you read the blog, you get huge amounts of comments about how difficult JIRA is to use. I've not seen one person say how awesome it is. For most users, they certainly don't have ambient joy

Oh, and since from Key Metrics, 60% of users don't have English as a first language, some language support would be good...

Maybe you could instigate a search on new reports, to throw up similar ones and ask is this your problem to cut down on the huge amount of duplicates, often there because the search has not used the same words. Fuzzy logic.


Saijanai Kuhn added a comment - 09/Jul/07 07:29 AM
I'm a geek (or at least like to think I am) and I have problems with Jira as well. When people like me (scripters) want to report a problem, we have to wade through stuff that is confusing to us, also. I know that the Lindens are aware of this issue because the geek-version of this issue, jira WEB-153, is now ranked as the #1 issue for the WEB project.

Saijanai Kuhn added a comment - 09/Jul/07 07:32 AM
Correction: WEB 153 is the number one jira issue, by votes, and the third highest WEB issue, by votes. Either way, the LIndens ARE aware of the issue. The upgrade no-doubt is meant to make it easier to get around, but I don't think its going to be nearly enough.

Saijanai Kuhn added a comment - 09/Jul/07 07:38 AM
The equivalent complaint by the geeks.

Celierra Darling added a comment - 09/Jul/07 11:31 AM
That issue doesn't seem really equivalent. It only talks about a certain problem (confusing categorization), not the whole bug-reporting process in general.

Torley Linden added a comment - 11/Jul/07 06:52 AM
I'm a casual person and appreciate such suggestions. I also value prior precedent, if you guys can point me to actual examples currently in use by other companies of really streamined bug reporting. PLEASE. Reason why – there doesn't appear to be a lot of precedent out there, and it helps to have inspiration to work from.

@Montana: re: language support, see my "change JIRA language tip" in:

» http://blog.secondlife.com/2007/07/05/how-to-report-bugs-better/

Let me ask Rob Linden about some of these suggestions too.

Also, Celierra or anyone who's comfortable: if you want to improve the actual Issue Tracker instructions:

» https://wiki.secondlife.com/wiki/Issue_tracker

since they're on the wiki, they're Resident-editable. Obviously, please don't excise anything essential, but feel free to clarify things which could be less cryptic.

Also research if some of the above is possible with built-in JIRA; some of the more obvious things-we-wanna-do like "Sort bugs by resolved date" are not, and require plugins.


Torley Linden added a comment - 17/Jul/07 01:24 PM
I checked with Rob about this and small safe changes should be easy to do. I'll work with him to make tweaks and assure it won't break our import/sync process – it's likely we'll do related ones in concentrated batches.

Torley Linden added a comment - 25/Jul/07 02:56 PM
Just wanted to update that some of the suggestions here, like wording changes, are really easily actionable – some isn't possible due to the limits of JIRA. To learn more about what's possible, see info on stuff like Dashboard portlets @ http://www.atlassian.com/software/jira/docs/latest/portlets_summary.html

Wish we could clearer break things into a checklist of sub-tasks here (as I'm used to doing in our internal Linden Lab JIRA) because some of the changes are greater in complexity and require plugins:, e.g.,

» http://confluence.atlassian.com/display/JIRAEXT/Filter+List+Plugin
» http://confluence.atlassian.com/display/JIRAEXT/Search+Plugin

I can modify the default Dashboard layout too – I hope to have a closer look at that when I have some spare cycles.

Oh, and I removed the "Clone" option.


Torley Linden added a comment - 25/Jul/07 03:43 PM
(OOH, we can use sub-tasks on the Issue Tracker! Try and divide this into smaller chunks if you'd like, Celierra.)

Celierra Darling added a comment - 26/Jul/07 09:03 PM
Thank you Torley! hugs

Still thinking about how to divide this up...


Celierra Darling added a comment - 27/Jul/07 11:59 AM
Split it into five tasks.

Lex Neva added a comment - 28/Jul/07 08:32 AM
I think that the "Linden Lab Issue ID" field should be made only accessible by Lindens, if possible. People constantly get confused and fill in an RT#, or their operating system, or an entire issue description in this box.

I've moved WEB-58 over to be a sub-task of this issue. I think that the fact that this JIRA can't send emails is a HUGE reason why new users have problems here. Often residents will stumble through and figure out how to submit a task, but we'll need to polish it up and get more details before LL will have enough information to act on. This usually means adding a comment and "resolving" the issue back to the reporter, but that's broken when the reporter never gets any notification of the comment and doesn't know how to check their existing issues. A lot of good, valid bugs get stranded because of this.

...that said, once emailing works, I'm sure I'll get a huge deluge of emails from all the issues I've commented. Heh.


Lex Neva added a comment - 28/Jul/07 08:38 AM
I think it might also be a good idea to make it more clear what priority people should give to each task. In the entire time this JIRA's been up, I've only seen two or three tasks that really truly deserved the BLOCKER priority. Blocker is only supposed to be used when the issue is so critical that all of SL grinds to a halt and that all LL development should grind to a halt while it's fixed. People often seem to declare an issue as a Blocker if SL grinds to a halt for THEM, ie for inability to log in or an obscure issue that they run into every day.

There's a nice handy description of what the priority levels are for if you click the ? button beside the priority dropdown, but most people don't read it. It might help to include it right with the priority dropdown on the create issue page, if possible. It would also help to clarify the priority level descriptions, such as "Major: major loss of function." If possible, it might be a good idea to limit setting the Blocker priority to the good-citizens or lindens groups.


Torley Linden added a comment - 01/Aug/07 02:08 PM
@Celierra: Awesome! Thanx, that'll help us focus better.

@Lex: Re: "Linden Lab Issue ID", great idea. Not sure how to limit JIRA fields to specific groups offhand, but I'll check with Rob. Very good point.

Followup is crucial too, makes for more lively discussion and participation.

I agree about clarifying priorities too... I have pretty much the same feelings about "Blocker", it's like, "It blocks ME!" Likewise, there are times when we have people mark crashes as "Critical" but noone else can repro/corroborate the info; those tend to be classed down to "Major" because their occurrence is rare. We need to keep emphasizing that part of our criteria for severity is # of Residents affected.

I'll also ping Iridium about this, she wrote a great Issue Tracker how-to @ http://secondlife.com/newsletter/2007_07/tips.html and I'm sure she'd have feedback.


Rob Kubrick added a comment - 07/Aug/07 11:21 AM
I've added my request for a couple of large filters. Because, I think it's easy to lose track of things for me, and I'm a fairly technical user.

Mercia Mcmahon added a comment - 28/Aug/07 06:17 AM
Just to clarify for those who are technical users of JIRA but not Concierge Account holders, outside North America, there is no such thing as an urgent response to support (unless you have a system for cheap international phone calls in place). In a recent blog entry after I posted something about Concierge ticket response times, no-one challenged the consensus that a billing query generally takes about one month to be resolved, and about two weeks to open. So the wiki or JIRA should not give out incorrect advice that urgent matters can be dealt with by support. I have no idea what the non-Concierge waiting times are, but they are presumably much longer.

Mercia


Mercia Mcmahon added a comment - 28/Aug/07 06:28 AM
I should add in response to Torley's question about other orgnisations' that as a long-time user of Open Source reporting systems, JIRA is simple to understand in comparison to something like Bugzilla (used by Mozilla among others) or Debian BTS. The only simpler things I have seen are just forums that the developers respond to, but that is inappropriately simple for something with as large a user-base as Second Life.

Although a website for reporting log-in failures (e.g., as an extension to all resident use of Region Down, which does have urgent response times to tickets), would help to cull the number of JIRA tickets that are Opened due to temporary grid problems and then clog up the database as Closed.

Mercia


WarKirby Magojiro added a comment - 27/Nov/07 02:54 PM
Change the behaviour of the quick search. Have it automatically sort issues by creation date (descending), then by votes(descending).

This will allow new users to quickly find relevant issues. ie, if they're having login problems, the login issue that someone else already made earlier that day will appear at the top of the list, and they can just click into it and vote.

That would drastically reduce the number of duplicates, I think.


Torley Linden added a comment - 28/Nov/07 08:03 AM
@WarKirby: I've wanted such a feature for awhile, but according to Atlassian, sorting columns persistently in the default navigator view (as accessed through Quick Search) isn't possible. Arg!

In lieu of that, the WindLight open bug list (as an example) – http://jira.secondlife.com/secure/IssueNavigator.jspa?mode=hide&requestId=10970 – is sorted by descending votes for the very reason you bring up.


Arawn Spitteler added a comment - 13/Mar/08 01:04 PM
Yeah, I wandered in, to add a feature to the LSL Wishlist, and have no idea where to go. I think it properly belongs in the LSL project, that should be suggested in the DOCumentation Project, which doesn't exist either.

Perhaps I could look up something in the KB, about looking things up in the Wiki, if I knew where to find the Index File. Let's make the Project Listings something the Users can understand. We wouldn't even have to call them Projects, if we don't care to explain what the term means.

"If we had an index file, we could look up the index file there."