Difference between revisions of "Github Helpdesk Working Document"

From WormBaseWiki
Jump to navigationJump to search
(Shuffled content and modified to make a little clearer.)
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
__TOC__
 
__TOC__
  
==='''''What this document should be used for:'''''===
+
==='''What this document should be used for:'''===
  
 
*Define the responsibilities of the staff member on helpdesk
 
*Define the responsibilities of the staff member on helpdesk
Line 12: Line 12:
 
* Ensuring that emails to wormbase-help/The github ticketing system are responded to in a timely manner
 
* Ensuring that emails to wormbase-help/The github ticketing system are responded to in a timely manner
 
* Preparing the agenda for the conference call
 
* Preparing the agenda for the conference call
** Compile it on the wiki on the [http://wiki.wormbase.org/index.php/Help_desk_schedule schedule]
+
** Compile it on the wiki on the [http://wiki.wormbase.org/index.php/Conference_calls conference call page]
 +
** Paste link to meeting notes on help desk schedule next your name [http://wiki.wormbase.org/index.php/Help_desk_schedule|help desk schedule]
 
** Example: [http://wiki.wormbase.org/index.php/WBConfCall_2013.03.07-Agenda_and_Minutes 2013.03.07]
 
** Example: [http://wiki.wormbase.org/index.php/WBConfCall_2013.03.07-Agenda_and_Minutes 2013.03.07]
 
* Acting as moderator during the call.
 
* Acting as moderator during the call.
Line 18: Line 19:
 
** Taking minutes
 
** Taking minutes
 
* Keep track of unanswered tickets and hand over to next [http://wiki.wormbase.org/index.php/Help_desk_schedule officer].
 
* Keep track of unanswered tickets and hand over to next [http://wiki.wormbase.org/index.php/Help_desk_schedule officer].
 
  
 
==='''User requests should be:'''===
 
==='''User requests should be:'''===
Line 27: Line 27:
  
 
* if not, the Help Desk officer is responsible for tracking and the initial answer.
 
* if not, the Help Desk officer is responsible for tracking and the initial answer.
 +
  
 
==='''User request Routes:'''===
 
==='''User request Routes:'''===
Line 43: Line 44:
 
=== GitHub ===
 
=== GitHub ===
  
Issues should now be tracked in the Issue Tracker on GitHub (https://github.com/WormBase/website/issues)
+
Issues should now be tracked in the Issue Tracker on GitHub (https://github.com/WormBase/website/issues?q=is%3Aissue+is%3Aopen+label%3AHelpDesk)
  
 
A guide on [[using github]].
 
A guide on [[using github]].
 +
 +
=== Tips/How To ===
  
  
===If a user emails help@wormbase.org ===
+
====If a user emails help@wormbase.org ====
  
 
Staff should either:
 
Staff should either:
Line 56: Line 59:
 
'''or'''
 
'''or'''
  
* Satff can forge a help request through the website (if you are not logged in you can enter the user's email) so that a github ticket is generated and the user gets an email to track the issue.
+
* Staff can forge a help request through the website (if you are not logged in you can enter the user's email) so that a github ticket is generated and the user gets an email to track the issue.
  
 
This reduces staff to a single point of user help requests and allows users to follow the course of issue resolution (they can see all the comments).
 
This reduces staff to a single point of user help requests and allows users to follow the course of issue resolution (they can see all the comments).
Line 84: Line 87:
 
'''or'''  
 
'''or'''  
  
failing that them self so that they can keep track of things that aren't answered.
+
Failing that them self so that they can keep track of things that aren't answered.
  
  
===How to reply to the user and update the github ticket ===
+
====How to reply to the user and update the github ticket ====
  
 
*Take the unique github email address assigned to the ticket
 
*Take the unique github email address assigned to the ticket
Line 112: Line 115:
 
*Helpdesk should make sure all issues are tracked on github (including those immediately resolved so we have the records in github), assign them when possible, merge or close when appropriate.
 
*Helpdesk should make sure all issues are tracked on github (including those immediately resolved so we have the records in github), assign them when possible, merge or close when appropriate.
  
===How to get the unique email address for email/git interaction ===
+
 
 +
====How to get the unique email address for email/git interaction ====
  
 
Staff with high level preferences get notification of all new tickets......so by default they get a unique address for all tickets.
 
Staff with high level preferences get notification of all new tickets......so by default they get a unique address for all tickets.

Latest revision as of 17:00, 21 March 2022

What this document should be used for:

  • Define the responsibilities of the staff member on helpdesk
  • Define how user responses can be professional/avoid unprofessional multiple responses etc.
  • People should add their experiences and any tricks they learn about how to bring together the help@wormbase.org and WebForm Help submissions so that future helpdeskers can work with the current system in an efficient manner.


The Help Desk officer is responsible for:

  • Ensuring that emails to wormbase-help/The github ticketing system are responded to in a timely manner
  • Preparing the agenda for the conference call
  • Acting as moderator during the call.
    • Following the Agenda
    • Taking minutes
  • Keep track of unanswered tickets and hand over to next officer.

User requests should be:

  • Replied to within 48 hours of a business day by a staff member with expertise in that area.
  • !!!! It's ok to leave the response until the appropriate curators are available to respond !!!! (within the 48hr period)
  • if not, the Help Desk officer is responsible for tracking and the initial answer.


User request Routes:

  • Website form submissions
    • Staff get 2 emails (if you are subscribed to github notifications which you should be)
      • One from the user to helps@wormbase.org (This is useful as it contains the users email address)
      • One from no-reply@github.org (this is useful as it contains the github unique ticket email address)
  • help@wormbase.org
    • Staff get a single email from the user
    • If the issues has been reported directly to help@wormbase.org
      • Create a github ticket by following the "If a user emails help@wormbase.org" section below and reply to the user. (The url to the ticket can be provided as it's an open resource)


GitHub

Issues should now be tracked in the Issue Tracker on GitHub (https://github.com/WormBase/website/issues?q=is%3Aissue+is%3Aopen+label%3AHelpDesk)

A guide on using github.

Tips/How To

If a user emails help@wormbase.org

Staff should either:

  • Create a github ticket directly in github

or

  • Staff can forge a help request through the website (if you are not logged in you can enter the user's email) so that a github ticket is generated and the user gets an email to track the issue.

This reduces staff to a single point of user help requests and allows users to follow the course of issue resolution (they can see all the comments).

  • Generates a unique github email to allow you to email the user and the ticket simultaneously.
  • good for staff in general.
  • Not so good for helpdesk.

and

  • Respond to the user
  • Assign the Issue

The helpdesk person should either assign the ticket to a curator if it is clear cut

or

assign the consortium partner manager:

OICR - Todd

Hinxton - Kev

Caltech - Nomination please


or

Failing that them self so that they can keep track of things that aren't answered.


How to reply to the user and update the github ticket

  • Take the unique github email address assigned to the ticket
EXAMPLE: reply+i-6153708-819580dd863a615e4f31a972751375cee704ec59-717707@reply.github.com
  • Reply to the original user email submission cc'ing the github unique ID (replace the no-reply@github.org) and help@wormbase.org.

Example:

to: John_smith@gmail.com
cc:  reply+i-6153708-819580dd863a615e4f31a972751375cee704ec59-717707@reply.github.com
cc: help@wormbase.org

Body: Thanks for your email, you can find the data on our ftp site ftp.wormbase.org

On 12/12/2012 06:02, John Smith wrote:
> blah blah blub
  • Any comment that is not intended directly for the user can simply be sent to the github email address or entered on the github web UI.
  • If the user request has been helped then the issue can be closed or the "helpdesk" label flipped to "helped" and other labels added if further development is required.
  • Helpdesk should make sure all issues are tracked on github (including those immediately resolved so we have the records in github), assign them when possible, merge or close when appropriate.


How to get the unique email address for email/git interaction

Staff with high level preferences get notification of all new tickets......so by default they get a unique address for all tickets.

This can be used when replying to the user to get the reply added to the ticket automatically.


Handover

When handing duties to the next officer, a summary of unanswered issues should be passed on in an email.


Help Email Archive

--Possibly not needed in this section?--

To view the Help Desk Archives click here (requires login and password): Help Desk Archives