clarifications and fixes in the broker errors section
Merge pull request #226 from stupakov/broker-error-documentation

clarifications and fixes in the broker errors section
revise content and format