Instructions for GitHub for GO: Difference between revisions

From GO Wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 1: Line 1:
[[Category: GO Consortium]]  
[[Category: GO Consortium]]  


==GitHub account==
=GitHub account=


==Main repositories and their scope==
=Main repositories and their scope=
* '''[https://github.com/geneontology/helpdesk Helpdesk]'''.  
* '''[https://github.com/geneontology/helpdesk Helpdesk]'''.  


Line 46: Line 46:
* Github Annotation Tracker Update
* Github Annotation Tracker Update
Make sure to look at these emails and comment on tickets that may impact your work as appropriate.
Make sure to look at these emails and comment on tickets that may impact your work as appropriate.
=GO projects=
* Within GitHub, group of related tasks are organized into 'projects'. 
* Projects may be associated with the top-level repository ([https://github.com/orgs/geneontology/projects]) or within individual repositories (see the 'Projects' tab within each repo).
* Projects may represent a task with a specific goal (for example, the conversion of Reactome data into GO-CAM models), or be an ongoing project (such as ontology development). In this case, projects are used to keep track of progress from one milestone to the next.
* Milestones usually correspond to GO Consortium meetings.
==Product Owner and Technical lead==
Each ongoing project has two key participants: the Product Owner and Technical lead.
* The '''Product Owner''' is responsible to provide user specifications for the project, and approve work done for public deployment.
* The '''Technical lead''' is responsible to propose technical solutions to implement the specifications, and to supervise the technical tasks.
* The Product Owner and Technical lead work together to agree on the scope of a project.

Revision as of 09:39, 8 April 2019


GitHub account

Main repositories and their scope

  • Ontology - Source files for the Gene Ontology.
  • Annotation - Annotation queries/issues, disputes, including PAINT disputes.
  • GO-site - A collection of metadata, tools, and files associated with the Gene Ontology public web presence.
  • AmiGO bugs and feature requests.
  • GO-CAM models and Noctua
    • noctua-models - GO-CAM models repository.
    • noctua - Repo for bug reports and feature requests for the Noctua Graph Editor workbench.
    • simple-annoton-editor - Repo for bug reports and feature requests for the Noctua Simple Annotation Editor workbench.
    • neo - Repo for bug reports and feature requests for the Noctua entity ontology.

Repo coordinators

Each repo has a coordinator. The responsibilities of the coordinator are to:

  • Add assignee(s) to each issue
  • Add labels as appropriate
  • Follow up
  • Propose prioritization for tickets (shared responsibility with product owner, technical lead, PIs, managers, creator of ticket, etc)

Procedure for using the GitHub repositories

  • Create issue in the appropriate tracker
  • If you want, add label for your group
  • Other labels are added by the repo coordinator

Tracking issues

When you are added as a member of the GO GitHub project, you automatically follow a number of repositories (different ones, depending on your role). By default, emails will be sent for all new and updated tickets. You can reduce this by going to the individual repo, and clicking on the 'eye' icon at the top right of the screen. Optinos are:

  • Not watching: Be notified only when participating (ie when you comment on a ticket or manually watch it)or @mentioned. This is the optimal option to get relevant information.
  • Releases only: Be notified of new releases, and when participating or @mentioned.
  • Watching: Be notified of all notifications
  • Ignoring: Never be notified

Daily Emails to go-consortium

Automatic emails are sent daily to the go-consortium mailing list with a list of the new and updated tickets for these two trackers:

  • Github Ontology Tracker Update
  • Github Annotation Tracker Update

Make sure to look at these emails and comment on tickets that may impact your work as appropriate.

GO projects

  • Within GitHub, group of related tasks are organized into 'projects'.
  • Projects may be associated with the top-level repository ([1]) or within individual repositories (see the 'Projects' tab within each repo).
  • Projects may represent a task with a specific goal (for example, the conversion of Reactome data into GO-CAM models), or be an ongoing project (such as ontology development). In this case, projects are used to keep track of progress from one milestone to the next.
  • Milestones usually correspond to GO Consortium meetings.

Product Owner and Technical lead

Each ongoing project has two key participants: the Product Owner and Technical lead.

  • The Product Owner is responsible to provide user specifications for the project, and approve work done for public deployment.
  • The Technical lead is responsible to propose technical solutions to implement the specifications, and to supervise the technical tasks.
  • The Product Owner and Technical lead work together to agree on the scope of a project.