rest: add some yard docs