make the inline documentation better