README: Update with example & issues

Fill out the README with some useful information. Include a description,
usage example, and a list of issues.

1 files changed, 43 insertions, 2 deletions

diff --git a/README.md b/README.md
index e0eb597..77a9c1b 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,49 @@
 git-checkout-history
 ====================
 
+Store history of your previously checked out git branches and quickly go back to recent branches.
 
+Here's an example of how it's used:
 
-
-	$ git checkout-save a-branch-name
+	$ git branch
+	* master
+	
+	$ git checkout-store -b new-feature
+	Switched to a new branch 'new-feature'
+	
+	$ git checkout-store -b feature-to-code-review
+	Switched to a new branch 'feature-to-code-review'
+	
+	$ git checkout-store master
+	Switched to branch 'master'
+	
+	$ git checkout-history
+	[1] feature-to-code-review
+	[2] new-feature
+	
+	$ git checkout-history 2
+	Switched to branch 'new-feature'
+	
 	$ git checkout-history
+	[1] master
+	[2] feature-to-code-review
+	[3] new-feature
+
+
+Branch history is stored in a file called `~/.git-checkout-history`. This is a YAML file that contains a list of previously stored branches.
+
+To make the tool easier to use, git aliases can be used:
+
+	$ git config --global alias.chs checkout-store
+	$ git config --global alias.ch checkout-history
+	
+	$ git chs a-branch
+
+
+## Known Issues
+* Currently, branch history is stored globally. When used in multiple repositories, all branches go to the same list. There should be a different branch storage list for each repository.
+* History never gets cleared. Not sure if this is actually an issue, but personally I don't really care about branch history from before the current day.
+
+
+## License
+Licensed under the MIT license. See the included LICENSE file.