We are documenting a resource -- there are no cookbook attributes that the user needs to override.  We should be documenting the parameters for each action and giving examples.  Please see [lvm readme](https://github.com/opscode-cookbooks/lvm#readme) for example.