added more documentation to get to 100% YARD coverage; fix YARD warnings