Better docs.
Merge pull request #2 from apiaryio/hj/docs

Better docs