Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Browse files

Working hard to make the README instructions extremely clear for newc…

…omers and workshop students.
  • Loading branch information...
commit 326ceb44e42e72949b667dceaeb87212019520da 1 parent 6458ae7
@croaky croaky authored
Showing with 18 additions and 14 deletions.
  1. +18 −14
@@ -1,33 +1,37 @@
thoughtbot dotfiles
-* Fork this repo.
-* Clone your fork.
-* Install.
-* Track thoughtbot/dotfiles.
-* Customize in master.
-* Update.
-From your cloned directory:
+First, [fork this repo]( on Github.
+Then, clone your Github fork (replace "your-github-name" with your Github name) onto your laptop and install it:
+ git clone
+ cd dotfiles
This will create symlinks for all config files in your home directory. You can
safely run this file multiple times to update.
-Note that there is configuration for `zsh` so if you'd like to switch your shell from the default `bash` to `zsh`, on OS X you do:
+There is configuration for `zsh` so switch your shell from the default `bash` to `zsh` on OS X:
chsh -s /bin/zsh
-Track thoughtbot/dotfiles
+Why fork?
+dotfiles are fairly personal. You should be able to modify your dotfiles, and save them in version control in your fork.
+However, the thoughtbot folks are often tweaking these dotfiles and you want to be able to get those updates.
+So, your master branch is meant for your customizations and use the `upstream` branch to get thoughtbot's updates.
+Set up the upstream branch
-One time:
+You only have to do this once:
git remote add upstream
git fetch upstream

0 comments on commit 326ceb4

Please sign in to comment.
Something went wrong with that request. Please try again.