improve YARD documentation