Updates

It would be particularly helpful to review the README and make sure it makes sense.
Does `:description` need to be included in the array?