User Tools

Site Tools


Collaborating with Git

Person 1: Create and setup new repository

  1. Create a repository on
  2. Make sure you have Git installed on your computer.
  3. Open Git Bash (Windows) or the Terminal (Mac/Linux) on your computer.
  4. You will be in a default directory. We will refer to this as the base directory. If you open Git Bash on Windows or the terminal on Mac, the base directory should be your user directory.
  5. Clone the beta repository to your base directory using https. Here is the command (PERSONONE is your GitHub username):
  6. Now you can modify source files, add code or new files
  7. Stage/add source files
    • `git add .`
  8. Commit changes:
    • `git commit -m "descriptive note"`
  9. Then push to your repository:
    • `git push origin master`

Person 2: Fork, add/modify, commit

  1. Fork repository on GitHub
  2. Visit the forked repository on your account and note the URL
  3. Clone that forked repository (where PERSONTWO is your GitHub username):
    • `git clone`
  4. Make code changes or add new files using your text editor
  5. Stage files for your repo:
    • `git add .`
  6. Commit files to your repo:
    • `git commit -m "comment"`
  7. Push changes to your repository on GitHub (will need to enter credentials):
    • `git push origin master`
  8. Visit your repo on GitHub. For example:
  9. Click: New Pull Request
  10. Click: Create Pull Request
  11. Submit pull request. Person 1 will need to review and accept.

Person 1: Accept pull request

  1. Accept on GitHub

Person 2: Syncs with Upstream

Person 2 needs to continue to make changes but must sync repo with Person 1 first.

  1. Inform git on local machine that there is an upstream repo:
    • `git remote add upstream`
  2. View list of remote repos:
    • `git remote -v`
  3. Sync your fork on local machine with upstream:
    • `git fetch upstream`
  4. Make sure you're on correct branch:
    • `git checkout master`
  5. Merge your fork with upstream:
    • `git merge/upstream`
  6. Check status:
    • `git status`
  7. Push back to GitHub
    • `git push`

Various commands and process notes

  1. `git pull` # update
  2. `git branch` # displays current branch
  3. `git branch feature1` # completely copies master branch to feature1
  4. `git checkout feature1`
  5. make code changes now
  6. `git status` # view changes
  7. `git add -A` # stage changes
  8. `git commit -m "comment"` # add comment
  9. `git branch` # display current branch
  10. `git checkout master` # switch back to master
  11. `git pull` # check to see if any changes to master; there were changes
  12. `git checkout feature1` # switch back to feature1
  13. `git merge master` # try to merge with master
  14. if conflict, then try to fix code if there were any changes
  15. `git status` # check status
  16. `git add -A` # state again
  17. `git commit -m "comment"`
  18. `git push ...`
  19. check github (main repo) and review pull request
  20. then can merge pull request on github, now into master branch; may delete feature1 now
  21. `git checkout master` # switch back to master
  22. `git pull` # to update master branch

Reverting to prior Git version

I installed a new Octopress theme and it garbled the website. To fix this, I needed to revert to a previous commit – the following fixed it, but since I'm still learning git, there might be a better way:

# checkout specific commit to revert to with its hash
git checkout 5430c628e1083d2897d9853cdb11cfd6743a6eac
git checkout -b fix_theme_mistake # name the checkout
git status # just to check
git checkout master # switch to master branch
git merge fix_theme_mistake # merge fix_theme_branch with master branch
git branch -d fix_theme_mistake # delete the fix branch because no longer needed
git push origin master # push to remote repository

Then redeploy to website with my Octopress script:

  1. Identify folder of interest where web files are located
  2. Modify (e.g., adding new post) and re-generate site
  3. Fix folder permissions; problem created when generating (need to investigate)
  4. Change to identified folder and fix descending permissions for directories and files
  5. Deploy site to server
folder = "$HOME/repos/octopress2/public/dailylog/blog"
rake generate
chmod 755 $folder
cd $folder && find . -type d -exec chmod 755 {} \; && find . -type f -exec chmod 644 {} \;
rake deploy
version-control/git-notes.txt · Last modified: 2019/02/17 13:58 by seanburns