Clarify that database.yml contains the runtime configuration
Remove the excess wordage at the end of the example
Improve whitespace around the headers
Add a header to the getting started section
Move the overview to the top and fill out more details
Add some basic documentation regarding the flow