Improvements to documentation

I used the master branch, as it was more up-to-date than the develop branch.

You may not want to pull the following commits:

* Changes to PHP example (mainly stylistic changes).

* Renamed README to README.md to make it clear that it's markdown formatted.