- Always work in branches
- Try to commit frequently whenever you make a major/minor change.
- Open a pull request on github and ask the project lead to review it before merging to
main
branch. - Follow the branch naming convention (below)
- When making a major change open an issue on github first then begin working on it. 1. This helps us communicate and document our work and keep an open discussion about things.
- The easiest way to do all of this is to use a front-end for GIT such as Visual Studio Code, github desktop, or git kraken. 1. It's also all doable in the command line.
- The format is YYYYMMDD/type_of_change/name_of_change
- Start with a datestamp in the format
YYYYMMDD
1. For example20230915
for september 15 2023 - type_of_change is what type of change you're making.
1. For example
feature
bugfix
documentation
refactor
- name_of_change is up to you just describe what it is you're doing.
- full example
20230915/bugfix/fix_infinite_while_loop
- Test test test the code when you make changes.
- Whether you write your code descriptively or use a ton of comments make sure others can understand your code.