OpenSDS NBP Project Contribution Tutorial

If you are a beginner and expect nbp project as the gate to open source world, this tutorial is one of the best choices for you. Just follow the guidance and you will find the pleasure to becoming a contributor.

Step 1: Fork nbp repository

Before making modifications of nbp project, you need to make sure that this project have been forked to your own repository. It means that there will be parallel development between nbp repository and your own repository, so be careful to avoid the inconsistency between these two repository.

Step 2: Clone the remote repository

If you want to download the code to the local machine, git is the best way:

git clone https://your_repository_url/nbp.git

Step 3: Configure upstream repository

To reduce the conflicts between your remote repository and nbp repository, we SUGGEST you configure nbp as the upstream repository:

git remote add upstream https://github.com/opensds/nbp.git
git fetch upstream

Step 4: Develop code locally

To avoid inconsistency between multiple branches, we SUGGEST checking out to a new branch:

git checkout -b new_branch_name upstream/devlopment
git pull

Step 5: Push the code to the remote repository

After updating the code, you should push the update in the formal way:

git add .
git status (Check the update status)
git commit -m "Your commit title"
git commit --amend (Add the concrete description of your commit)
git push origin new_branch_name

Step 6: Pull a request to nbp repository

In the last step, your need to pull a compare request between your new branch and nbp development branch. After finishing the pull request, the travis CI will be automatically set up for building test.