update README

- fix mistakes, cleanup in general
- fill in missing sections
- require js section is WIP, current progress pasted in comment :)

fixes #72, #73