Add api documentation for service brokers

Signed-off-by: Zach Robinson <zrobinson@pivotallabs.com>