I agree that the README should contain all information regarding attributes and their use in addition to any comments that are provided in attribute files.  When I look at the README for a cookbook I prefer to get as much information about it up front as possible.