Workflow

GitHub Flow

Bordertech recommend following the GitHub Flow workflow. GitHub developed this workflow to make it easy to collaborate on projects regardless of their size or technical expertise.

Summary of workflow

1. Create a feature branch from the repository.
2. Create, edit, rename, move, or delete files in the new branch.
3. Send a pull request from your branch with your proposed changes to kick off a discussion.
4. Make changes on your branch as needed. Your pull request will update automatically.
5. Merge the pull request once the branch is ready to be merged.
6. Tidy up your branches using the delete button in the pull request or on the branches page.

Tips

• Anything in the master branch is deployable.
• Mandate pull requests when merging feature branches.
• Mandate code reviews when merging into master.
• Always create a new branch to perform a release. Refer here for information specific to releases.
• Delete feature and release branches once merged.

Variations

For a large piece of development work with a number of team members, it is recommended to:-

1. Create a development branch off master.
2. Team members create feature branches off the development branch.
3. Team members do pull requests to merge features into the development branch.
4. When ready to release, create a release branch off the development branch. Once released perform a pull request into master.
5. Delete the development and release branches.

Note:- This is a simplified version of Git Flow.

References

• https://help.github.com/articles/github-flow/
• https://githubflow.github.io/
• https://guides.github.com/introduction/flow/