fix for issue 1; documentation tweaks