readme: add documentation for CB

This is how I envision this would work based on our discussion. 

@csfrancis @camilo thoughts?