This is a request for phpDoc comments.
Probably the best phpDoc creator is
phpCodumentor. Already in the current state of source code it provides a quite nice documentation, but of course this is no reason to not go with the documentation standard.
This would help contributors a lot.
Please think about it.
phpDocumentor documentation created by phpDocumentor (you can see other default output formats at
http://phpdoc.org/docs/