more documentation
Fix utf8 error after commit to the db
change a couple things in the readme

Refine grammar in the readme