Overview
Browse to the Liquibase Core project in GitHub: https://github.com/liquibase/liquibase
Make sure the default branch is master
Fork it
Clone it to your local system
Make a new branch
Make your changes
Push your changes back into your repo
Click the Compare & pull request button
Click Create pull request to open a new pull request at liquibase/liquibase
Step-by-Step Instructions
1. Browse to the Liquibase Core project in GitHub
Open a browser and navigate to the Liquibase project in GitHub: https://github.com/liquibase/liquibase
2. Select master as the default branch
3. Fork the Liquibase Core Project
Click on the Fork button in the top-right corner.
This creates a new copy of Liquibase under your GitHub user account with a URL like:
https://github.com/<YourUserName>/liquibase
and includes all the code, branches, and commits from the original repo.
4. Clone the repository
Clone the source code repo
Clone the source repo by opening the terminal on your computer and running the command:
git clone https://github.com/<YourUserName>/liquibase
This repo also includes the unit tests for Liquibase Core. See this page for more information on writing or enhancing Liquibase Core unit tests.
5. Create a branch and set the upstream repository
Once the repo is cloned, you need to do two things:
Create a new branch by issuing the command:
git checkout -b new_branch
Create a new remote for the upstream repo with the command:
git remote add upstream https://github.com/liquibase/liquibase
In this case, "upstream repo" refers to the original repo you created your fork from.
6. Make your changes
Now you can make your changes and additions to Liquibase Core.
7. Push the changes back to your repo
Push your changes back to your repo in GitHub.
git push -u origin <newBranchName>
When you do, the Compare & pull request button will appear in GitHub.
8. Create a new pull request at liquibase/liquibase
Open a pull request by clicking the Compare & pull request button. This allows the Liquibase maintainers to review your contribution. Click it and you'll be taken to this screen:
9. Fill out the pull request template, and click the Create pull request button
This will submit your pull request for our team to review.
10. Receive updates on your pull request
Thank you for submitting your pull request! We will review it for completeness, prioritize it, and schedule it to be integrated into Liquibase Core. You will receive updates on the progress of your PR in the comment section of your PR’s GitHub page.