The point of my post wasn't whether or not the readme was accurate.  It was really about selling your product.

Don't make me the consumer hunt for vital information about your product.  Don't leave me the consumer left wondering what I'm getting for my money.  Come out and tell me what's in your product and sell it to me.  Show me what I can do with your product.  Make me think I need your product for my next project.

If I'm left wondering, then that is instantly going to make me not click the add to cart button.