README.md in librarian-0.0.12 vs README.md in librarian-0.0.13
- old
+ new
@@ -10,11 +10,11 @@
The mock source is in-process and in-memory and does not touch the filesystem or the network.
Librarian::Chef
---------------
-An adapter for Librarian applying to Chef cookbooks in a Chef Repository.
+An adapter for Librarian applying to Chef cookbooks in a Chef Repository. When used with Chef, Librarian is really for pulling in the 50 or so finished third-party cookbooks that you're using, not the 1 or 2 cookbooks you're actively working on.
## Install librarian:
$ gem install librarian
@@ -22,10 +22,11 @@
__Make sure your cookbooks directory is gitignored__
$ cd ~/path/to/chef-repo
$ git rm -r cookbooks # if the directory is present
$ echo cookbooks >> .gitignore
+ $ echo tmp >> .gitignore
Note that librarian *takes over* your cookbooks directory
and manages it for you based on your Cheffile. Your
Cheffile becomes the authoritative source for what
cookbooks you have, rather than the directories in your
@@ -38,11 +39,11 @@
__Add dependencies and their sources to Cheffile__
$ cat Cheffile
site 'http://community.opscode.com/api/v1'
cookbook 'ntp'
- cookbook 'timezone'
+ cookbook 'timezone', '0.0.1'
cookbook 'rvm',
:git => 'https://github.com/fnichol/chef-rvm',
:ref => 'v0.7.1'
__install dependencies into ./cookbooks__
@@ -57,10 +58,10 @@
__Update your cheffile with new/changed/removed constraints/sources/dependencies__
$ cat Cheffile
site 'http://community.opscode.com/api/v1'
cookbook 'ntp'
- cookbook 'timezone'
+ cookbook 'timezone', '0.0.1'
cookbook 'rvm',
:git => 'https://github.com/fnichol/chef-rvm',
:ref => 'v0.7.1'
cookbook 'monit' # new!
$ git diff Cheffile