edits to broker documentation