re-apply misc changes that have since been overwritten by merging of PRs
clarify difference between the two ruby example brokers
Merge pull request #250 from stupakov/service-brokers

re-apply more misc changes that have since been overwritten by merging of PRs