The protobuf definitions allow comments that will transfer into the generated code. Move the API description from the README into proto, but leave high level description in README.