re-apply changes to broker errors section

These were originally accepted as part of https://github.com/cloudfoundry/cf-docs/pull/226, but they have been overwritten.  Needs to be merged in again.