Clean Up ReadMe Documentation

[tylerkrupicka]

Right now the documentation in the ReadMe is a little hard to follow and could use some improvements. I think it would be helpful to:

• Break apart the modern and legacy generation into separate sections which explain the differences in how they work and how you use them.
• Create a legend at the top of the readme that links to individual configuration options or examples.
• Clean up headers and documentation text.

[anjaliguptaz]

@tylerkrupicka Is this still valid and needs to be done ?

[anchal0997]

Hi @tylerkrupicka, I would like to contribute to this issue.