Update README.md files

[rayrfan]

Writing a good readme.md is complex but necessary

• https://medium.freecodecamp.org/how-to-get-up-to-3500-github-stars-in-one-week-339102b62a8f
• https://github.com/matiassingers/awesome-readme
• https://github.com/noffle/art-of-readme

Do the following

• use badges (https://shields.io/)
• use img or gif
• have contribution info
• make separate pages for it! -- but keep your README succinct
• add CONTRIBUTING.md https://github.com/blog/1184-contributing-guidelines

Readmes I like

• https://github.com/twbs/bootstrap
• https://github.com/aimeos/aimeos-typo3
• https://github.com/amitmerchant1990/electron-markdownify
• https://github.com/choojs/choo
• https://github.com/Day8/re-frame
• https://github.com/gitpoint/git-point

A helpful checklist to gauge how your README is coming along:

One-liner explaining the purpose of the module
Necessary background context & links
Potentially unfamiliar terms link to informative sources
Clear, runnable example of usage
Installation instructions
Extensive API documentation
Performs cognitive funneling
Caveats and limitations mentioned up-front
Doesn't rely on images to relay critical information
License