We will be using the Git workflow detailed here.
Never commit to master
and never commit to develop
. Instead, create a branch or a fork, work on that, and then submit a pull request.
Here are the steps to do that:
git checkout develop
This will switch you to the develop branch.git pull
This will make sure your develop branch is up to date.git checkout -b branch-name
This will checkout a new branch with the name branch-name.- Write some code, commit it.
git push -u origin branch-name
This will push your branch to Github. You only need to do this once per branch.- Submit a pull request
- If there are changes that need to be made make them
git push origin branch-name
Each commit should reflect a small, isolated change. Avoid having one commit cover an entire feature. For example, if the feature you're working on is user registration you might have the following commits:
- Added HTML for registration page.
- Styled registration page.
- Created API for registering new user.
- Added Angular controller to handle user registration.
Please refrain from garbage commit messages like jfdkjsfkjsf. All pull requests with these will be denied. Instead, use the following template:
Short message describing the basics of what you did. (<80 characters)
Optional longer description describing any special things you did.
We will be using 4 boards:
- Backlog: These are tasks that no one is working on. They may or may not be assigned to anyone yet.
- In Progress: If you start working on a task move it here. This corresponds with making a branch for a task.
- Staging: Once you submit a pull request move the task here.
- Done: After I accept the pull request I will move the task here.