clean up a chunk of the docs
No empty space for hidden fields
convert the README to Markdown :octocat:
remove old / misleading code
:sparkles: