updating README.rst

* bring syntax highlighting for PHP code blocks under github
* bunch of grammar
* some rewordings