docs: jsonalchemy field definition documentation

It was a discussion we had at the beginning (python was even an option at that point)

All the formats have some things that we could use, but some of our needs felt unnatural in most of them, en the end we came up with this nice cocktail ;-)