re-apply changes to broker errors section
Merge pull request #248 from stupakov/broker-error-documentation-2

re-apply changes to broker errors section