documentation: clearing up broker->node communication