Improve documentation on property types

[maeve]

The current documentation is hard to follow. The README is a little too basic and the rdocs are hard to navigate. The README should be expanded to include an example of passing a lambda as the :type, and link to the appropriate place in the (similarly expanded) rdocs.