better documentation of communicator with traceables