Using GitHub to Collaborate on We Enhance IT Projects

At We Enhance IT, each application or project is associated with a single GitHub repository. Collaboration and project management on these projects is encourage through semi-standardized use of the tools provided by GitHub and associated with a repository.

Some key aspects of collaboration:

• Use git to manage code and documents
  Learn more [here](Using Git) on how We Enhance IT utilizes git to collaborate. Key point is that the main always represents the latest released version of the application and there always is a develop branch which is the most up to date working copy of the application under development.

• Use the issues section of the repository as a project management tool
  Each issue is a assigned a tag, then meaning of which is defined [here](We Enhance IT - Standard Tags for GitHub Issues). By filtering issues by tag and milestone - collaborators can review tasks, functionality, items requiring review or problems.

• Milestones are Release Versions
  Milestones are generally the Release Version ( format of the version is defined [here](We Enhance IT Release Version Guidline) ) In cases where a 'sub' milestone is appropriate, then the milestone is the Version, followed by an underscore, followed by a milestone title. A project is initiated by defining a new release - described by a set of issues tagged specification and a task list defined by a set of issued tagged specification

• Major discussions are held in the repository Wiki Every repository should have a section entitled Implementation Discussions. This will be a page of links to discussions that allow collaborators to contribute thoughts, document ideas, raise questions or provide feedback on aspects of the project that are not appropriate for the issues sections. Note that there may be issues raised to request input or review of these Wiki items.

• We use a Rails 5 Vagrant box to create and update the project, run the tests, and run the server for development and test purposes

• All the proposed and agreed upon rules for collaboration are documented in this wiki

• All contributors are encouraged to expand on the collaboration rules

• For anything not stated in here, each of us has the freedom to do what we choose