improvements to generated README

change "requirements" to "supported platforms"
remove narrative around replacing samples with real data
provide sensible defaults for samples that are more likely to be used
use simple markdown format
fix broken generator test
Merge pull request #915 from berkshelf/improve-generated-readme

improvements to generated README