clarifications and fixes in the broker errors section