generate annotations in yml format

replaces #568

i went with yml rather than annotations. what would annotations do, service definitions by annotations?

this seems like a very strange line...