yh: add some documentation