[x3d-public] Metadata clarifications in X3D4

Don Brutzman brutzman at nps.edu
Tue May 11 11:27:45 PDT 2021


Dick, Jakub and I worked for some time on trying to ensure that little or no ambiguity was possible regarding metadata (the field) and metadata (information) in the specification.

Small editorial refinements, with much amplification:

===========================================================
* https://www.web3d.org/member-only/mantis/view.php?id=1361

Summary	0001361: 7.3.5 X3DNode /metadata/ field description and clarification for each Metadata* node

Description
a. Need to add clarifying sentence:

The /metadata/ field provides metadata information about the current node, as described in [7.2.4 Metadata].

b. Proposed further addition to clarify/disambiguate semantics of /metadata/ field and metadata as a word, for each node definition 7.4.1 though 7.4.6:

Replace "The metadata provided by this node"

with "The metadata information provided by this node"

Additional Information
a. First statement matches our regular practice of defining all fields.

b. Second statement was originally intended as a potential clarification of MetadataSet field semantics, likely for 7.4.5 Metadata. This is a long-running point of confusion that has led to convoluted metadata models and discussions, hoping for a clarification of rules that is useful.

Disambiguating "metadata" field (incorrect) and "metadata" information (correct) in each case by simply stating "metadata information" provides a helpful and consistent reinforcement for each of the relevant nodes.

This is a difficult issue for avoiding editorial ambiguity, many iterations led to the current refined prose.
===========================================================

This is all in X3D4 Core Component.
https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD/Part01/components/core.html

all the best, Don
-- 
Don Brutzman  Naval Postgraduate School, Code USW/Br       brutzman at nps.edu
Watkins 270,  MOVES Institute, Monterey CA 93943-5000 USA   +1.831.656.2149
X3D graphics, virtual worlds, navy robotics http://faculty.nps.edu/brutzman



More information about the x3d-public mailing list