We need to write docbook documentation for the individual api methods of phongo.
These need to clarify the input, output, expectations, exceptions thrown etc etc etc.
This will function as the spec for our core extension (e.g. api docs for phongo/hippo)