fix up README

few grammar mistakes and some clarification addendums
add example application for gh-pages. no auth required