improve inline documentation for behaviors