Heaps more inline documentation from Jac …

Heaps more inline documentation from Jacob landed.

#documentation, #phpdoc