Difference between revisions of "WormBase Staff Resources"

From WormBaseWiki
Jump to navigationJump to search
 
(41 intermediate revisions by 3 users not shown)
Line 3: Line 3:
 
= Accounts =
 
= Accounts =
  
To make it easier to collaborate as a team, WormBase utilizes a number of tools provided by Google, but all located under the wormbase.org domain.
+
It's strongly encouraged that all team members of WormBase request a '''wormbase.org''' account.
  
This list includes a Docs, Mail, Calendar, Discussion lists, collaborative chat, and contact information for all team members.
+
=== Why wormbase.org accounts? ===
  
With a you@wormbase.org account, you will automatically have access to core documents, contact information for all project members, and all tools mentioned above, as well as automatic privileges on the WormBase web site. Interested users can request an account from ToddIf you're not interested you can continue to use your existing account information with less seamless integration.
+
Perhaps you already have a caltech, oicr, google, or account on some other service.  But a '''wormbase.org''' account is fundamentally different. It's not just an email account but access to a shared suite of tools.
 +
 
 +
Unifying resources like documents and calendars under wormbase.org '''facilitates collaboration'''.  It increases '''project transparency'''.  And it '''decreases administration overhead'''.
 +
 
 +
With a wormbase.org account, you will automatically be granted access to project calendars, documents, a contact list of team members, subscriptions to mailing lists.  '''You''' can manage your own account information. Moreover, a '''*.wormbase.org''' account instantly grants additional privileges on the new WormBase website. As people matriculate onto the project they can quickly integrate with other team members and be brought up to speed with a shared corpus of documentation.  They'll have immediate access to remote members via Google Chat or Voice, too.
 +
 
 +
This seamless integration is provided by Google Apps and includes the following services:
 +
 
 +
* Gmail
 +
* Google Docs
 +
* Calendars
 +
* Discussion Groups
 +
* Google Chat
 +
* Shared Contacts
 +
 
 +
=== Cool. Integration is good and I want a wormbase.org account, but want to read email elsewhere. ===
 +
 
 +
No problem. Log on to your account once and set your email to forward to your secondary account. DoneNote that you will still need to send email to the discussion groups (see below) using the account to which you are subscribed.
 +
 
 +
=== What if you don't want a wormbase.org account? ===
 +
 
 +
Fine. You can still subscribe to things like the discussion groups using your old email.  But you won't benefit from the seamless integration of these collaborative tools and you'll be less accessible to other members of the team.
  
 
= Discussion Groups (Mailing Lists) =
 
= Discussion Groups (Mailing Lists) =
  
WormBase uses a number of [[Mailing_lists|mailing lists]] for discussion.  You can manage subscriptions yourself, add posts, view threads, and search the archive all from the web.
+
WormBase uses a number of [[Mailing_lists|mailing lists]] for discussion provided by Google Groups.  You can manage subscriptions yourself, add posts, view threads, and search the archive all from the web.
  
== Creating your own discussion group ==
+
=== Creating your own discussion group ===
  
With your wormbase.org account, you can also create your own groups, a perfect way to support new projects.  One advantage of this approach over using ad-hoc distribution lists in your email client is the ability to archive discussions and made searchable to wormbase.org account holders or to the wider web.  This option can be disabled if desired.
+
With your wormbase.org account you can also create your own groups.  This is a perfect way to support new side projects.  Advantages of this approach over using ad-hoc distribution lists in your email client include the ability to let others easily use the discussion group, as well as the ability to create searchable archives of discussions available to the entire web or only subscribed members.
  
See the [https://groups.wormbase.org groups main page] for details.
+
See the [https://groups.wormbase.org groups main page] and the [[Mailing_lists|Mailing List]] Wiki page for details.
  
 
= Calendar =
 
= Calendar =
  
You can add and edit events to the official WormBase calendars.
+
'''*@wormbase.org''' account holders can add and edit events on the official WormBase calendars.
  
 
:http://calendar.wormbase.org/
 
:http://calendar.wormbase.org/
 +
 +
There are three calendars:
 +
 +
: WormBase (private events) -- ''a calendar of project events, including conference calls, etc''
 +
: WormBase Build Schedule -- ''a calendar or scheduling build related dates (handovers/deadlines)''
 +
: [http://www.google.com/calendar/embed?src=d6un9opku070sg8ngike6v4ki0%40group.calendar.google.com&ctz=America/Yellowknife WormBase Public Events] -- ''a calendar listing public events like meetings''
  
 
= Documents =
 
= Documents =
Line 30: Line 57:
  
 
:http://docs.wormbase.org/
 
:http://docs.wormbase.org/
 +
 +
Any new documents created under your wormbase.org account can be easily shared with all other wormbase.org account holders. You'll need to add users outside of the wormbase.org domain specifically.
  
 
= Email =
 
= Email =
  
You can access your official WormBase email account at:
+
'''*@wormbase.org''' account holders can access email at:
  
 
:http://mail.wormbase.org/
 
:http://mail.wormbase.org/
  
You may wish to set up your account preferences to forward email to a private account.
+
If desired, email can be forwarded to a secondary account.
  
 
= Contacts =
 
= Contacts =
  
= Social Media =
+
''To be written...''
 +
 
 +
= Issue Tracker =
  
== Blog ==
+
WormBase has a single unified issue tracker.  Be sure to join the project on github so that you can get updates on issues you report!
  
The official WormBase blog is called "M9":
+
:https://github.com/WormBase/website/issues
  
:http://blog.wormbase.org/
+
=== Reporting Guidelines ===
  
This is our primary vehicle for communication with users.  You can subscribe to the blog via email at:
+
# Don't worry if something warrants reporting or not. If in doubt, report it!
 +
# Be sure you are LOGGED IN. We may need additional information from you.
 +
# Provide an informative title -- eg: ''Phenotypes on the Gene Page are lacking evidence display''
 +
# Label issues related to web development with "Webteam"
 +
# Include as much detail as necessary to explain the issue. More is always better. Example URLs are great, too.
  
:http://feedburner.google.com/fb/a/mailverify?uri=wormbase&loc=en_US
+
=== What information to include in the issue ===
  
== Twitter ==
+
Including the following information will help the web team resolve your issues as soon as possible.
  
Our Twitter account is:
+
'''For all issues:'''
 +
# Descriptive title
 +
#* '''Bad''': ''Genes are broken''. '''Good''': ''Expression widget on gene page returning 500 error''
 +
# URL to the affected page
 +
#* if this issue affects several objects, it's helpful to include a variety of URLs for testing
 +
# Summary of the request
 +
#* Affected pages/widget
 +
#* What happens now '''VS''' What should happen
 +
#* Screenshots are helpful
  
:http://twitter.com/wormbase
 
  
We have a secondary account for source code commits:
+
'''For an error:'''
 +
# Describe: What happened
 +
#* Step-by-step information if you can
 +
# Describe: Expected results - what should happen here?
 +
# Describe: Actual results - what is wrong?
 +
#* Error message received (if any)
 +
# Is it reproducible?
 +
#* Always? Sometimes? Unable to reproduce?
 +
# Environment: What Operating System / Browser were you using? (ie Windows XP and Internet Explorer 8)
 +
# Environment: Are you on staging or production?
 +
# Add the label '''bug'''
  
:http://twitter.com/wormbase-commits
 
  
= Issue Tracker =
+
'''For a feature request:'''
 +
# For new data
 +
#* Describe where this data is - acedb tag? other data source?
 +
#* Describe where you want it displayed - what page/widget?
 +
#* Describe how you want it displayed - as a link? an image? a table?
 +
# Add the label '''feature request'''
  
You can follow and track issues at:
+
=== Following through on issues ===
  
:https://bitbucket.org/tharris/wormbase/issues?status=new&status=open
+
# Keep on top of issues you report.
 +
# Add comments to issues to maintain a history directly in the system. Followers receive emails automatically.
 +
# if there isn't progress, "bump" the issue or leave a comment!
  
 
= Source Code =
 
= Source Code =
  
Source code is currently maintained in Mercurial (hg):
+
WormBase has source code in git.  We consolidated all of our code in GitHub under a single WormBase organization umbrella.
 +
 
 +
:https://github.com/WormBase
 +
 
 +
= Social Media =
 +
 
 +
=== Blog ===
 +
 
 +
The official WormBase blog:
 +
 
 +
:http://blog.wormbase.org/
 +
 
 +
This is our primary vehicle for communication with users.  You can subscribe to the blog:
 +
 
 +
:via RSS http://feeds.feedburner.com/wormbase
 +
:via email http://feedburner.google.com/fb/a/mailverify?uri=wormbase&loc=en_US
 +
 
 +
there is a secondary blog for ParaSite announcements at https://wbparasite.wordpress.com
 +
 
 +
=== Twitter ===
 +
 
 +
Our main Twitter account is:
 +
 
 +
:http://twitter.com/wormbase
  
:https://bitbucket.org/tharris/wormbase
+
We have secondary accounts:
 +
: for source code commits: http://twitter.com/wormbase-commit
 +
: for the Hinxton group: https://twitter.com/wormbasehinxton
 +
: for WormBase ParaSite: https://twitter.com/WBParasite

Latest revision as of 14:30, 14 January 2016

This document describes collaborative tools available to WormBase team members.

Accounts

It's strongly encouraged that all team members of WormBase request a wormbase.org account.

Why wormbase.org accounts?

Perhaps you already have a caltech, oicr, google, or account on some other service. But a wormbase.org account is fundamentally different. It's not just an email account but access to a shared suite of tools.

Unifying resources like documents and calendars under wormbase.org facilitates collaboration. It increases project transparency. And it decreases administration overhead.

With a wormbase.org account, you will automatically be granted access to project calendars, documents, a contact list of team members, subscriptions to mailing lists. You can manage your own account information. Moreover, a *.wormbase.org account instantly grants additional privileges on the new WormBase website. As people matriculate onto the project they can quickly integrate with other team members and be brought up to speed with a shared corpus of documentation. They'll have immediate access to remote members via Google Chat or Voice, too.

This seamless integration is provided by Google Apps and includes the following services:

  • Gmail
  • Google Docs
  • Calendars
  • Discussion Groups
  • Google Chat
  • Shared Contacts

Cool. Integration is good and I want a wormbase.org account, but want to read email elsewhere.

No problem. Log on to your account once and set your email to forward to your secondary account. Done. Note that you will still need to send email to the discussion groups (see below) using the account to which you are subscribed.

What if you don't want a wormbase.org account?

Fine. You can still subscribe to things like the discussion groups using your old email. But you won't benefit from the seamless integration of these collaborative tools and you'll be less accessible to other members of the team.

Discussion Groups (Mailing Lists)

WormBase uses a number of mailing lists for discussion provided by Google Groups. You can manage subscriptions yourself, add posts, view threads, and search the archive all from the web.

Creating your own discussion group

With your wormbase.org account you can also create your own groups. This is a perfect way to support new side projects. Advantages of this approach over using ad-hoc distribution lists in your email client include the ability to let others easily use the discussion group, as well as the ability to create searchable archives of discussions available to the entire web or only subscribed members.

See the groups main page and the Mailing List Wiki page for details.

Calendar

*@wormbase.org account holders can add and edit events on the official WormBase calendars.

http://calendar.wormbase.org/

There are three calendars:

WormBase (private events) -- a calendar of project events, including conference calls, etc
WormBase Build Schedule -- a calendar or scheduling build related dates (handovers/deadlines)
WormBase Public Events -- a calendar listing public events like meetings

Documents

WormBase documents are available at:

http://docs.wormbase.org/

Any new documents created under your wormbase.org account can be easily shared with all other wormbase.org account holders. You'll need to add users outside of the wormbase.org domain specifically.

Email

*@wormbase.org account holders can access email at:

http://mail.wormbase.org/

If desired, email can be forwarded to a secondary account.

Contacts

To be written...

Issue Tracker

WormBase has a single unified issue tracker. Be sure to join the project on github so that you can get updates on issues you report!

https://github.com/WormBase/website/issues

Reporting Guidelines

  1. Don't worry if something warrants reporting or not. If in doubt, report it!
  2. Be sure you are LOGGED IN. We may need additional information from you.
  3. Provide an informative title -- eg: Phenotypes on the Gene Page are lacking evidence display
  4. Label issues related to web development with "Webteam"
  5. Include as much detail as necessary to explain the issue. More is always better. Example URLs are great, too.

What information to include in the issue

Including the following information will help the web team resolve your issues as soon as possible.

For all issues:

  1. Descriptive title
    • Bad: Genes are broken. Good: Expression widget on gene page returning 500 error
  2. URL to the affected page
    • if this issue affects several objects, it's helpful to include a variety of URLs for testing
  3. Summary of the request
    • Affected pages/widget
    • What happens now VS What should happen
    • Screenshots are helpful


For an error:

  1. Describe: What happened
    • Step-by-step information if you can
  2. Describe: Expected results - what should happen here?
  3. Describe: Actual results - what is wrong?
    • Error message received (if any)
  4. Is it reproducible?
    • Always? Sometimes? Unable to reproduce?
  5. Environment: What Operating System / Browser were you using? (ie Windows XP and Internet Explorer 8)
  6. Environment: Are you on staging or production?
  7. Add the label bug


For a feature request:

  1. For new data
    • Describe where this data is - acedb tag? other data source?
    • Describe where you want it displayed - what page/widget?
    • Describe how you want it displayed - as a link? an image? a table?
  2. Add the label feature request

Following through on issues

  1. Keep on top of issues you report.
  2. Add comments to issues to maintain a history directly in the system. Followers receive emails automatically.
  3. if there isn't progress, "bump" the issue or leave a comment!

Source Code

WormBase has source code in git. We consolidated all of our code in GitHub under a single WormBase organization umbrella.

https://github.com/WormBase

Social Media

Blog

The official WormBase blog:

http://blog.wormbase.org/

This is our primary vehicle for communication with users. You can subscribe to the blog:

via RSS http://feeds.feedburner.com/wormbase
via email http://feedburner.google.com/fb/a/mailverify?uri=wormbase&loc=en_US

there is a secondary blog for ParaSite announcements at https://wbparasite.wordpress.com

Twitter

Our main Twitter account is:

http://twitter.com/wormbase

We have secondary accounts:

for source code commits: http://twitter.com/wormbase-commit
for the Hinxton group: https://twitter.com/wormbasehinxton
for WormBase ParaSite: https://twitter.com/WBParasite