inline documentation improvements