Forks
Last updated
Last updated
A fork is a copy of a database. The fork model exists so that you control who can modify your data, and determine what data gets merged. You can continue to pull changes from the database that you forked from, and you can submit pull requests back to it. You can use it as a tool to get your changes onto a database, or you can use it to take that database in a different direction.
Forks on DoltHub are useful in two main ways:
You can propose changes to a database you don't have write permissions to
You can experiment with or adopt someone else's database for your own use case without making changes to the original data
You can create a fork, making changes to your fork, and then submit a pull request in the original database.
GitHub forks are very similar to DoltHub forks in both purpose and practice.
You can use the fork button on the top right of any database to fork the database to your own namespace. We will use our us-schools database as an example.
There is now a fork of us-schools in our namespace called taylor/us-schools. We can either edit directly on DoltHub or clone and edit using Dolt.
If you forked a database to do your own experimenting, your work here is done. However, if you'd like to propose changes to the base database, you can create a pull request by navigating to dolthub/us-schools and clicking one of the new pull request buttons.
Select your fork as the "From database" and select a branch and title.
The owner of the base database (in this case dolthub) can then request any changes in your pull request and merge if they approve the request.
You can also update your fork with the latest changes from the upstream database using the pull request form in your own database.
