generate annotations in yml format

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

indeed. just saw it cut the trailing blank, but it looks like a whole paragraph was lost during some editing here... would need to look at blame i guess or the history of this file to figure it out. can do tonight.