improved inline documentation