When contributing to this repository, please first discuss the change you wish to make at Issues.
- MySQL (version >= 8.0.28) (MariaDB)
- Python (version >= 3.8.10)
- Python Virtual Environments
We follow Git Flow for changes to this repository. If you're not familiar with using git and GitHub on the command line, GitHub Desktop is an easier alternative.
- Fork this repo to create a copy hosted on your GitHub account. The Fork button is in the top right of the page.
- If you're a collaborator on the repo you can instead create a branch.
- Clone down your copy of this repo onto your local machine:
git clone <YOUR GITHUB REPO URL>
- Navigate to the new directory git created:
cd SMSwithoutborders-BE
- See Configurations steps to configure your development environment.
- Create a new branch for your work based on main:
git checkout -b <YOUR BRANCH NAME>
Your branch name should be something descriptive of the changes you wish to make, and can include the issue number this change is associated with. Example:feature/1234-update-documentation
- Make your changes. When you're ready to apply your changes, push your changed files to your forked repo:
git add <FILENAMES OF CHANGED FILES>
git commit -m "<YOUR COMMIT MESSAGE>"
Your commit message should be descriptive of the changes you made.git push -u origin HEAD
This will push your changes to the branch you created on your forked repo.
- Open a Pull Request to the
SMSwithoutborders-BE
repo:- Navigate to the SMSwithoutborders-BE repo
- Select
New pull request
- Select
Compare across forks
- Select
base repository: SMSwithoutborders-BE
- Select
base branch: main
- Select
head repository: <YOUR FORKED REPOSITORY>
- Select
head branch: <YOUR BRANCH NAME>
- Select
Create pull request
Your pull request will be reviewed and we'll get back to you!