yard doc improvements

Signed-off-by: Ken Barber <ken@bob.sh>