I'm somewhat biased but after looking long and hard for a good rest documentation system, i think this is the right way to do it.