added some YARD documentation