If you want to contribute to this project and make it better, your help is very welcome. Remember that the the noblest of all contributions is a good, clean pull request.
- Make sure you have a GitHub account.
- Create a personal fork of the project on GitHub.
- Clone the fork on your local machine. Your remote repo on GitHub is called
origin
. - Add the original repository as a remote called
upstream
.- Run
git remote add upstream https://github.com/luigidifraia/ByteBoozer2.git
.
- Run
- If you created your fork a while ago be sure to pull
upstream
changes into your local repository.- To pull from
master
, rungit pull upstream master
.
- To pull from
- Create a new topic branch to work on. Branch from
develop
if it exists, else frommaster
.- To create a topic branch
my-contribution
based onmaster
, rungit checkout -b my-contribution master
.
- To create a topic branch
- Implement/fix your feature(s); comment your code.
- Follow the code style of the project, including indentation.
- Add or change the documentation as needed.
- Make commits of logical and atomic units.
- Push your changes to the topic branch in your fork of the repository.
- To push to
my-contribution
, rungit push origin my-contribution
.
- To push to
- From your fork open a pull request in the correct branch. Target this project's
develop
branch if there is one, else go formaster
. - If the maintainer requests further changes, just push them to your topic branch. The pull request will be updated automatically.
- Once the pull request is approved and merged you can pull the changes from
upstream
to your local repository and delete your extra branch(es).