Docs improvements

* Explicitly mark methods as public
* Improve method PHPdoc