Skip to content

Latest commit

 

History

History
98 lines (65 loc) · 2.69 KB

CONTRIBUTING.md

File metadata and controls

98 lines (65 loc) · 2.69 KB
Raw

How to contribute

OceanBase Database is a community-driven open source project and we welcome all the contributors. Contributions to the OceanBase Database project are expected to adhere to our Code of Conduct.

Before you contribute

Before you contribute, please click the Sign in with GitHub to agree button to sign the CLA. You can find an example here.

What is CLA?

Contribution guide

Please follow these steps to create your Pull Request to this repository.

Note:

This section takes creating a PR to the master branch as an example. The steps of creating PRs for other branches are similar.

Step 1: Fork the repository

  1. Visit the project (https://github.com/oceanbase/oceanbase)
  2. Click the Fork button to establish an online fork.

Step 2: Clone your fork to local

# Define your working directory
working_dir=$HOME/Workspace

# Configure GitHub
user={your GitHub profile name}

# Create your clone
mkdir -p $working_dir
cd $working_dir
git clone git@github.com:<your group>/oceanbase.git

# Go to your clone
cd oceanbase

# Add upstream
git remote add upstream git@github.com:<your group>/oceanbase.git

# Set no push for the upstream master
git remote set-url --push upstream no_push

# Confirm your remote setting
git remote -v

Step 3: Create a new branch

  1. Get your local master up-to-date with the upstream/master.

    cd $working_dir/oceanbase
git fetch upstream
git checkout master
git rebase upstream/master

  2. Create a new branch based on the master branch.

    git checkout -b new-branch-name

Step 4: Develop

Edit some file(s) on the new-branch-name branch and save your changes.

Step 5: Commit your changes

git status # Checks the local status
git add <file> ... # Adds the file(s) you want to commit. If you want to commit all changes, you can directly use `git add.`
git commit -m "commit-message: update the xx"

Step 6: Keep your branch in sync with upstream/master

# While on your new branch
git fetch upstream
git rebase upstream/master

Step 7: Push your changes to the remote

git push -u origin new-branch-name # "-u" is used to track the remote branch from the origin

Step 8: Create a pull request

  1. Visit your fork at https://github.com/$user/oceanbase (replace $user with the GitHub account which you performed the fork operation, the repo name is oceanbase by default and you may want to modify it).

  2. Click the Compare & pull request button next to your new-branch-name branch to create your PR.