improved documentation text