doc improvements. YARD coverage up to 62.50%