clarifications and fixes in the broker errors section

removed list of HTTP status codes whose purpose was not 100% clear
replaced it with a note saying that the broker can respond with any valid status code
fixed the name of the "description" field in error responses
remove trailing whitespaces.