README.md in prj-0.0.1 vs README.md in prj-0.0.2
- old
+ new
@@ -1,26 +1,48 @@
Prj
==========
+[![Build Status](https://secure.travis-ci.org/v-yarotsky/prj.png)](http://travis-ci.org/v-yarotsky/prj)
+[![Code Climate](https://codeclimate.com/github/v-yarotsky/prj.png)](https://codeclimate.com/github/v-yarotsky/prj)
+[![Gem Version](https://badge.fury.io/rb/prj.png)](http://badge.fury.io/rb/prj)
+
Cd to your project the right way!
-Prj chooses a project directory based on fuzzy matching
+Prj chooses a project directory based on fuzzy matching.
-Usage:
-------
+It finds a project directory (a directory with .git/ or other vcs directory inside) such that it's name
+contains supplied letters in given order. The search is scoped by projects root
+directory, which is specified in ~/.prj.yml config file (Default: ~/Projects).
+See Installation & Configuration section.
-Put this into your .zshrc (.bashrc)
+Installation & Configuration:
+-----------------------------
+1. Install the gem:
-```
-function p() {
- builtin cd "$(prj $1)"
-}
-```
+ ```gem install prj```
-Put a project root directory into ~/.prj, i.e:
+ ([RVM](http://rvm.io) users) check out [this blog post](http://blog.yarotsky.me/2012-12-15-faster-ruby-scripts-startup)
+2. ([oh-my-zsh](https://github.com/robbyrussell/oh-my-zsh) users) Put [scripts/zsh/prj.plugin.zsh](https://raw.github.com/v-yarotsky/prj/master/scripts/zsh/prj.plugin.zsh) into ``~/.oh-my-zsh/custom/plugins/prj/prj.plugin.zsh``.
+ Don't forget to enable the plugin in ~/.zshrc
+3. Put a project root directory name into ~/.prj.yml, i.e:
+ ```
+ projects_root: ~/Projects
+ vcs_directories:
+ - .git
+ - .svn
+ - .hg
+ ```
+
+Usage:
+------
+
+With the following directory structure
```
-~/Projects
+~/
+ Projects/
+ my_super_project/
+ rails/
+ love_hate_unicorns/
```
-
-and run ```p letters_from_your_project_folder_name```
+You can reach ``~/Projects/my_super_project`` with ```p msp```