improved documentation yet more