improving docmentation of methods in preperation for #19