The annotations include a little more data than is strictly necessary because we will also have a protoc generator for openapi output.