add YARD documentation to new/affected methods