docs: clarify json validation