consul/docs/contributing/fork-the-project.md

1.1 KiB

Forking the Consul Repo

Community members wishing to contribute code to Consul must fork the Consul project (your-github-username/consul). Branches pushed to that fork can then be submitted as pull requests to the upstream project (hashicorp/consul).

To locally clone the repo so that you can pull the latest from the upstream project (hashicorp/consul) and push changes to your own fork (your-github-username/consul):

  1. Create the forked repository (your-github-username/consul)
  2. Clone the hashicorp/consul repository and cd into the folder
  3. Make hashicorp/consul the upstream remote rather than origin: git remote rename origin upstream.
  4. Add your fork as the origin remote. For example: git remote add origin https://github.com/myusername/consul
  5. Checkout a feature branch: git checkout -t -b new-feature
  6. Make changes
  7. Push changes to the fork when ready to submit a PR: git push -u origin new-feature