README.md in gitdocs-0.0.2 vs README.md in gitdocs-0.1.0

@@ -1,13 +1,67 @@
 # Gitdocs
 
+Collaborate on files and docs through a shared git repository. gitdocs will automatically push changes to the repo as well as pull in changes.
+This allows any git repo to be used as a collaborative task list or wiki for a team.
+
+You can also start a web front-end allowing the repo to be viewed through the browser.
+
 ## Installation
 
+Install the gem:
+
 ```
 gem install gitdocs
 ```
 
+If you have Growl installed, you'll probably want to run `brew install growlnotify` to enable Growl support.
+
 ## Usage
 
-From the git repo you want to sync with, run `gitdocs`.
+First add the doc folders to watch:
 
-If you have Growl installed, you'll probably want to run `brew install growlnotify` to enable Growl support.
+```
+gitdocs add my/path/to/watch
+```
+
+You can remove and clear paths as well:
+
+```
+gitdocs rm my/path/to/watch
+# or gitdocs clear
+```
+
+You need to startup gitdocs:
+
+```
+gitdocs start
+```
+
+You can also `stop` and `restart` gitdocs as needed. Run
+
+```
+gitdocs status
+```
+
+for a helpful listing of the current state. Once gitdocs is started, simply start editing or adding files to your
+designated git repository. Changes will be automatically pushed and pulled to your local repo.
+
+You can also have gitdocs fetch a remote repository with:
+
+```
+gitdocs create my/path/for/doc [e-mail]:user/some_docs.git
+```
+
+This will clone the repo and add the path to your watched docs. Be sure to restart gitdocs
+to have path changes update:
+
+```
+gitdocs restart
+```
+
+To view the docs in your browser with file formatting:
+
+```
+gitdocs serve
+```
+
+and then visit `http://localhost:8888` for access to all your docs in the browser.