Document mapping of snake_case to lowerCamelCase when validating json

[pnrobinson]

Document mapping of snake_case to lowerCamelCase when validating json

The protobuf schema uses snake_case:

time_at_last_encounter

however, when I run pfx-tools example, the json examples using lowerCamelCase

E.g.

  "subject": {
    "id": "proband C",
    "timeAtLastEncounter": {
      "age": {
        "iso8601duration": "P27Y"
      }
    },

At first I thought this was a bug, but I see it is documented (albeit in the most cursory fashion) in the protobuf docs:

https://developers.google.com/protocol-buffers/docs/proto3#json

I suspect this is highly non-obvious to non-proto-geeks.

Add this here: https://phenopacket-schema.readthedocs.io/en/latest/schema.html

[andrewpatto]

This was definitely non-obvious to me (as a non-proto person)