Update barn documentation.

These are some updates after looking at barn for a bit.
Merge pull request #10 from soundcloud/conor/docs

Update barn documentation.