turn on hapi doc generation plugin

And begin adding descriptions to routes.

We should be able to change the doc templates but there's a bug with `lout` at the moment.

@dannycoates r?