Section 4.7 says:
"name" identifies the JSON string form for the name property while "nameMap" represents the object form.
Later:
Accordingly, in the JSON serialization, the terms " name", "summary", and "content" represent the JSON string forms; and the terms " nameMap", "summaryMap", and " contentMap" for represent the object forms.
This describes the serialization of these properties: one is a string, the other is an object. It doesn't describe what they're for, though. When should a publisher use name, and when should they use nameMap? Can they use both? Why or why not?
I think we use these as default plus variant. name is the default name in the language of the document; nameMap is all the alternate names in other language (maybe including the default name).
Section 4.7 says:
Later:
This describes the serialization of these properties: one is a string, the other is an object. It doesn't describe what they're for, though. When should a publisher use
name, and when should they usenameMap? Can they use both? Why or why not?I think we use these as default plus variant.
nameis the default name in the language of the document;nameMapis all the alternate names in other language (maybe including the default name).