improved documentation accuracy