added swagger annotated documentation to the services - we need plugin v0.7 before we can do more detailed documentation :(