[frankfrank13]

I have long used protobuf as the source of truth for API's, but it does have some weird idiosyncrasies since its primarily a binary spec, and doesn't always transfer to json well (e.g optionals, maps, etc).

[andremedeiros]

That's totally fair feedback. Particularly optionality having been removed from proto2 to proto3 is confusing.