further yard documentation progress

:page_facing_up: