How to work off of a feature branch

This guide describes how to set up a local branch while working off of a feature branch.

Step 1: Create your branch

• Fetch the most recent changes on the upstream remote

  git fetch upstream

• Create the local branch off of the upstream remote branch

  # example: git checkout -b wins-feature-1 upstream/wins-feature-1
  # {FEATURE BRANCH NAME} needs to be identical to the feature branch name on the upstream remote repo
  git checkout -b {FEATURE BRANCH NAME} upstream/{FEATURE BRANCH NAME}

• Create your new branch off of the new feature branch that you just created!!

  git checkout -b {YOUR BRANCH}

Step 2: Update your branch with upstream changes

• Update the branch with the latest changes using the following command

  # example: git pull upstream wins-feature-1
  git pull {NAME OF REMOTE} {FEATURE BRANCH NAME}

Step 3: Create a pull request

• Stage and commit your changes

  git add {FILES CHANGED}
  git commit -m "{COMMIT MESSAGE}"

• Push changes to your remote

  # this is the same as always
  git push origin {YOUR BRANCH}

• Create a pull request that is comparing across forks, from your branch to the feature branch
  • The into branch should be the feature branch you based your local branch off in Step 1: Create your branch. As an example, continuing from the example given in step 1, the into branch for that pull request would be set to hackforla:wins-feature-1.