Skip to content

Development Workflow

This guide explains the steps to be taken when making changes or updates to this repository.

1. Create branch for feature/fix

  • Allows the user to test changes without affecting the main branch.

2. Pull latest updates from main branch to avoid conflicts

  • Useful to ensure the user does not overwrite recent changes or do what someone else has already done.
  • Also ensures that any code the user adds will be compatible with existing code.

3. Make changes (update docs as needed)

  • Change files to achieve the desired results.
  • Will not affect main branch, so minimal risk.

4. Commit

  • These act as save points. If later code causes issues, a previous commit can be reverted to.

5. Push

  • This allows others to see the branch the user has created and edit it.
  • The branch stays seperate from the main branch.

6. Pull request

  • Proposes merging the new branch with the main branch.
  • Allows for changes to be considered by others; they may notice things the user who created the branch did not.

7. Some team member reviews pull request and gives feedback if they have any

  • example feedback: add comments for clarity, include corresponding documentation, improve variable naming, this part could be simplified.
  • this process can keep team members informed, encourage better code quality and help us learn from each other's work.

8. Merge branch into main

  • Moves the changes made in the branch into the main branch.
  • Ensures that other users will have the updated code when they make branches

9. Delete branch

  • The commits made are not deleted, only the branch itself