Add some documentation
Rename item and items to resource and resources.

This is what other gems do. This will also help us make some method
names more consistent
Rename current_object_class to resource_class
Simplify mass-assignment
Fix tags
Add some documentation, fix readme
Update yardopts