Confirmed users
5,365
edits
Thunderbird/Support/Workflow: Difference between revisions
change from short url to GS tag url
(change from short url to GS tag url) |
|||
| (41 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
__TOC__ | __TOC__ | ||
{{draft}} | {{draft}} | ||
This page documents Mozilla Messaging Support Workflows for Mozilla Messaging Staff and volunteer champions including Bugzilla, SuMoMo Knowledge Base (SuMoMo is the codename for the KB only deployment of SUMO on support.mozillamessaging.com | This page documents Mozilla Messaging Support Workflows for Mozilla Messaging Staff and volunteer champions including Bugzilla, SuMoMo Knowledge Base (SuMoMo is the codename for the KB only deployment of SUMO on support.mozillamessaging.com ) and Get Satisfaction | ||
== Get Satisfaction == | == Get Satisfaction == | ||
| Line 17: | Line 17: | ||
# Change to an "Idea" if it's a feature request | # Change to an "Idea" if it's a feature request | ||
# If you think it's a blocker to a future Thunderbird release, tag it "review" (the review tag will be removed at a future, periodic [[Thunderbird/Support/Workflow#GS_Triage|GS Triage meeting]]) | # If you think it's a blocker to a future Thunderbird release, tag it "review" (the review tag will be removed at a future, periodic [[Thunderbird/Support/Workflow#GS_Triage|GS Triage meeting]]) | ||
# If there's an existing bug, post a link to it and tag it "bug nnnnn" e.g. bug 532489 | # If a SuMoMo kb article update or a new article is required, tag it "add to SuMoMo". (If the article is relevant to programmers instead of users, tag it "add to MDC".) | ||
#* If you want to help further, create a bug in Bugzilla (under the product "support.mozillamessaging.com"). Link to the Get Satisfaction article in the bug description. On Get Satisfaction, tag it with the bug number "bug nnnnnn" (e.g. "bug 123456") and "docs bug added" and leave a comment with a link to the bug. | |||
#* If you want to help even further, write the article in the Knowledge Base, then close the bug and update the Get Satisfaction issue with the tag "documented on SuMoMo" and a link to the URL of the article. | |||
# If there's an existing bug, post a link to it in a comment and tag it "bug nnnnn" e.g. bug 532489 | |||
# If not, and you think a bug needs to be created, create a bug, see "Bugzilla" | # If not, and you think a bug needs to be created, create a bug, see "Bugzilla" | ||
# URL Tags | |||
#* If this Get Satisfaction topic is a duplicate of another GS topic THEN decide which one is canonical and tag the duplicate ones as "duplicate of shorturlOfCanonicalThread" e.g. [http://getsatisfaction.com/mozilla_messaging/tags/duplicate_of_http_gsfnustnr95 "duplicate of http://gsfnustnr95"] | |||
#* "from:short url" "from:http://gsfn.us/kdjk", (GS URLs that feed into this topic) | |||
#* "see:short url" e.g. "see:http://gsfn.us/kdjk" (GS URLs that this topic references) | |||
=== Merge workflow === | === Merge workflow === | ||
| Line 48: | Line 55: | ||
If you feel your reply answers the question 80% and you have moderation abilities, i.e. you are a Mozilla Messaging Employee or champion, then: | If you feel your reply answers the question 80% and you have moderation abilities, i.e. you are a Mozilla Messaging Employee or champion, then: | ||
==== Change the Status ==== | |||
* use "Moderator Updates" on the right Sidebar and set the status to "Answered" for Questions and "Solved" for Problems '''after''' you have submitted your reply. | |||
==== Always explain status changes ==== | |||
* Folks get upset if you change the status of a GS topic. The GS web page usability is not clear when a status changes; folks get upset when a status change is not explained so of whenever you change the status of a reply (e.g. to "not a problem" or to "Solved" or "Answered") '''always add an explanation''' e.g. "Setting this to Solved (or Answered) because I am pretty sure this [[[fill in the blanks]]] solves your problem." If it turns out that's it not Solved or Answered then set the topic to Problem, In progress. | |||
==== Change to a Problem if appropriate ==== | |||
* If you look at a topic and leave a reply but it's not Answered or Solved then change it to a Problem and set status to "Acknowledged" or "In Progress" if that make sense.Try not to leave topics that you reply to without updating the status. | |||
==== Merge Duplicate Threads ==== | |||
* Lots of times, users post multiple duplicate threads. This of course makes support harder than it should. Best thing is to catch it early and merge them using GS's merge facility. However 90% of the time, you won't catch it early. In this case it's best to anoint a "canonical thread" (or start a new one) and leave it at "Problem, In progress" and close (i.e. set to Question, Answered or Problem, Solved) the other duplicate threads (but of course link to the canonical thread and state clearly that you are leaving the canonical thread open so people won't be offended you are closing the duplicate threads). Tag the canonical thread "canonical" plus "canonical [1-3 word topic summary]" e.g. "canonical message preview". for an example see: http://gsfn.us/t/ooa7. | |||
==== Create a summary thread if users post their problem across multiple threads ==== | |||
* Lots of times, desperate users post fragments or all of their problems as replies to multiple (let's call it 'n') threads. This would be great if their problems were 100% identical to the problems in the multiple threads and if the threads were active. Unfortunately 99% of the time the problem is not the same and more than 50% of the time the thread is inactive or hopelessly muddled and confusing with several users asking for help with multiple similar but not identical problems. | |||
* In their desperation, they don't realize that this makes it more difficult to help them. They figure that this will maximize the exposure and likelihood of getting a response. | |||
* '''Recommendation''': Create a new "summary" support topic for them with a relevant title and with content paraphrasing all of their problem across all the threads. And then post a reply (using the [[Thunderbird/Support/GetSatisfaction/BoilerPlate#Use_one_topic.2C_not_multiple_topics|"use one topic, not multiple topics boilerplate"]]) on all 'n' (or at least 2 of n) of their threads linking to the summary support topic and unsubscribe from the other threads in Get Satisfaction. | |||
=== Give Thanks === | === Give Thanks === | ||
| Line 57: | Line 76: | ||
# If it's a complete answer or solution, leave a comment e.g. something like "Thanks for contributing to community support." | # If it's a complete answer or solution, leave a comment e.g. something like "Thanks for contributing to community support." | ||
# If their answer or question is incomplete or a wee bit inaccurate, post a reply (comments are really only meant for short items) with a correction or an addition to make their answer/solution complete and thank the person as well | # If their answer or question is incomplete or a wee bit inaccurate, post a reply (comments are really only meant for short items) with a correction or an addition to make their answer/solution complete and thank the person as well | ||
# If a person | # If a person supports the community on a regular basis (e.g. several worthwhile replies a month), please consider making them a GS "champion" for Mozilla Messaging | ||
=== Dealing with Profanity, Insults and Personal Attacks === | |||
Get Satisfaction's [http://getsatisfaction.com/ccpact Company-Customer Pact] and Mozilla's community culture requires both staff and users to be respectful and considerate. | |||
If you see a post on Mozilla Messaging's Get Satisfaction site that contains profanity or insults and you are not a GS moderator, email the link and a request for removal of either just the the profanity or the entire reply or topic to: | |||
* (Mozilla staff) support AT getsatisfaction.com | |||
* (Mozilla contributors) roland AT mozillamessaging.com | |||
'''Get Satisfaction Moderators''' | |||
==== Removing Replies that contain attacks and/or profanity ==== | |||
If you are a Get Satisfaction Moderator, then '''feel free to remove replies that are attacks or have profanity without useful information''' (if you want to retain the reply but redact the profanity see "Removing Profanity and Attack Language from Replies"). Use the [[Thunderbird/Support/GetSatisfaction/BoilerPlate#Removing_Replies_that_contain_attacks_and.2For_profanity|boilerplate for Removing Replies that contain attacks and/or profanity]] | |||
==== Archive the topic if there's profanity and only 1 ranter & ranter doesn't really want help ==== | |||
If there's only 1 user (or several users all of whom are profanely ranting and not helping) is merely ranting with profanity or attack language and doesn't really want help from the community, use the GS "Archive" feature to archive the topic so it doesn't show up in search results. Use [[Thunderbird/Support/GetSatisfaction/BoilerPlate#Archive_the_topic_if_there.27s_profanity_and_only_1_ranter_.26_ranter_doesn.27t_really_want_help|"Archive the topic if there's profanity and only 1 ranter & ranter doesn't really want help" boilerplate explanatory language]] | |||
==== Removing Profanity and Attack Language from Replies ==== | |||
If the user does really want community support despite the rant, then reply with [[Thunderbird/Support/GetSatisfaction/BoilerPlate#Removing_Profanity_and_Attack_Language_from_Replies|"Removing Profanity and Attack Language" reply text and emoticon text]] | |||
== Bugzilla == | == Bugzilla == | ||
=== New Bug Workflow === | === New Bug Workflow === | ||
once a GS topic or through some other support channel) has been determined to be a bug that hasn't been previously filed, then | once a GS topic or through some other support channel) has been determined to be a bug that hasn't been previously filed, then | ||
# a bugzilla bug needs to be filed and linked and tagged into the GS topic | # a bugzilla bug needs to be filed and linked and tagged into the GS topic(s) (e.g. if the bug is bug 62345 make sure all relevant GS topics are tagged "bug 62345") and '''please''' fill in the GS tag url (e.g. http://getsatisfaction.com/mozilla_messaging/tags/bug_62345 ) into the bug's URL field and add "[gs]" to the whiteboard | ||
# this bug needs to be triaged into an appropriate release and GS folks need to be informed | # this bug needs to be triaged into an appropriate release and GS folks need to be informed by adding a reply to the GS topic with the results of the triage | ||
# if necessary a workaround needs to be developed and then added to SuMoMo if substantial enough and/or as a GS topic | # if necessary a workaround needs to be developed and then added to SuMoMo if substantial enough and/or as a GS topic | ||
=== GS Triage === | === GS Triage === | ||
Triage means driving the number of topics tagged "review" in Get Satisfaction down to zero by creating a bug and setting the bugzilla flag(s) appropriately or by finding an existing bug | Triage means driving the number of topics tagged "review" in Get Satisfaction down to zero by creating a bug and setting the bugzilla flag(s) appropriately or by finding an existing bug | ||
==== Bugzilla GS related whiteboard conventions ==== | |||
* "[gs?]" if there is a need to find matches in Get Satisfaction or to see if this bug has been reported by users in Get Satisfaction | |||
==== Triage process for periodic GS triage meetings ==== | ==== Triage process for periodic GS triage meetings ==== | ||
For each GS topic tagged "review" i.e. for all | ===== GS -> Bugzilla ===== | ||
For each GS topic tagged "review" i.e. for all problem reports in | |||
[http://getsatisfaction.com/mozilla_messaging/tags/blocker getsatisfaction.com/mozilla_messaging/tags/review ]: | [http://getsatisfaction.com/mozilla_messaging/tags/blocker getsatisfaction.com/mozilla_messaging/tags/review ]: | ||
# if | # if the problem is actually a bug, search for an equivalent existing BMO bug | ||
# if there is no existing BMO bug, create a new one | |||
# '''in the GS topic''': add the tag "bug nnnnnn" (where nnnnnn is the BMO bug number) | |||
# '''in BMO bug nnnnnn''': in the whiteboard field, add "[GS]" | |||
# in the URL field, add a link to the GS tag, like this: http://getsatisfaction.com/mozilla_messaging/tags/bug_nnnnnn | |||
# in a new comment, add the short URL of the GS topic (Right Sidebar->Share tab->Get a short URL) and the current GS topic summary; add "(canonical)" after the short URL if the GS topic has been tagged "canonical", like this: | |||
http://gsfn.us/t/xyz (canonical) | |||
Problem with Thunderbird | |||
# nominate the bug as blocking if appropriate | |||
# triage the bug in bugzilla using the normal bugzilla flags for the appropriate release | # triage the bug in bugzilla using the normal bugzilla flags for the appropriate release | ||
# post an reply to the GS topic stating an existing bug was found or a new bug was created and that a tentative release has been established (as always never promise a specific date or release for a fix). Mark this reply by clicking "Mark as company solution" so that this reply is highlighted | # post an reply to the GS topic stating an existing bug was found or a new bug was created and that a tentative release has been established (as always never promise a specific date or release for a fix). Mark this reply by clicking "Mark as company solution" so that this reply is highlighted | ||
| Line 92: | Line 133: | ||
If it causes customer pain, then it should be reviewed | If it causes customer pain, then it should be reviewed | ||
e.g. anti-virus problems, dataloss, a feature that requires further polish e.g. making autoconfig manual config easier or more obvious, a missing feature that would ease user pain, etc. | e.g. anti-virus problems, dataloss, a feature that requires further polish e.g. making autoconfig manual config easier or more obvious, a missing feature that would ease user pain, etc. | ||
Some ways to detect customer pain in GS: | |||
# The ones with the most Me Toos i.e. http://getsatisfaction.com/mozilla_messaging/admin/topics and then click on "Me Toos" to get the topics that most folks have said they are having problems with | |||
# The ones with the most Replies i.e. http://getsatisfaction.com/mozilla_messaging/admin/topics and then click on "Replies" to get the topics that have the most replies, these generally are painful | |||
===== Bugzilla query for GS bugs ===== | ===== Bugzilla query for GS bugs ===== | ||
[https://bugzilla.mozilla.org/buglist.cgi?status_whiteboard_type=allwordssubstr;query_format=advanced;status_whiteboard=%5Bgs%5D;resolution=--- bugzilla.mozilla.org/buglist.cgi?status_whiteboard_type=allwordssubstr;query_format=advanced;status_whiteboard=<nowiki>[gs]</nowiki>;resolution=--- ] | [https://bugzilla.mozilla.org/buglist.cgi?status_whiteboard_type=allwordssubstr;query_format=advanced;status_whiteboard=%5Bgs%5D;resolution=--- bugzilla.mozilla.org/buglist.cgi?status_whiteboard_type=allwordssubstr;query_format=advanced;status_whiteboard=<nowiki>[gs]</nowiki>;resolution=--- ] | ||
===== Bugzilla -> GS ===== | |||
Once a Bugzilla bug that has [gs] has been fixed: | |||
* add [gssolved] in the bug | |||
* edit the GS topic and add a tag "bug nnnnn fixed" and fixedbuild e.g. "fixed3.1", "fixed3.2" | |||
* ask users in the GS topic to test the fix in the build it is fixed in e.g. 3.1 | |||
== SuMoMo Knowledge Base == | == SuMoMo Knowledge Base == | ||