updating README.rst

* bring syntax highlighting for PHP code blocks under github
* bunch of grammar
* some rewordings
Merge pull request #6 from hashar/patch-1

updating README.rst