added more YARD documentation