x_ite 8.8.7 → 8.9.1

package/docs/_posts/components/CADGeometry/IndexedQuadSet.md

@@ -1,6 +1,6 @@
 ---
 title: IndexedQuadSet
-date: 2022-01-07
+date: 2023-01-07
 nav: components-CADGeometry
 categories: [components, CADGeometry]
 tags: [IndexedQuadSet, CADGeometry]
@@ -13,9 +13,9 @@ tags: [IndexedQuadSet, CADGeometry]
 
 ## Overview
 
-IndexedQuadSet is a geometry node that defines quadrilaterals. IndexedQuadSet can contain Color/ColorRGBA, Coordinate/CoordinateDouble, Normal and TextureCoordinate nodes.
+IndexedQuadSet is a geometry node that defines planar quadrilaterals. IndexedQuadSet contains a Coordinate or CoordinateDouble node, and can also contain Color or ColorRGBA, Normal and TextureCoordinate nodes.
 
-The IndexedQuadSet node belongs to the **CADGeometry** component and its default container field is *geometry.* It is available since X3D version 3.1 or later.
+The IndexedQuadSet node belongs to the **CADGeometry** component and its default container field is *geometry.* It is available from X3D version 3.1 or higher.
 
 ## Hierarchy
 
@@ -30,23 +30,25 @@ The IndexedQuadSet node belongs to the **CADGeometry** component and its default
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
 
-### MFInt32 [in] **set_index** <small>[0,∞)</small>
+#### Hint
 
-*index* values provide order in which coordinates are applied. Order starts at index 0, commas are optional between sets. Four unique indices are defined for each quadrilateral.
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
-#### Warning:
+### MFInt32 [in] **set_index** <small>[0,∞)</small>
 
-- -1 sentinel values are not allowed.
+Input field *set_index*.
 
 ### SFBool [ ] **solid** TRUE
 
-Setting solid true means draw only one side of polygons (backface culling on), setting solid false means draw both sides of polygons (backface culling off).
+Setting *solid* true means draw only one side of polygons (backface culling on), setting *solid* false means draw both sides of polygons (backface culling off).
 
-#### Hint
+#### Hints
 
-- If in doubt, use solid='false' for maximum visibility.
+- Mnemonic "this geometry is *solid* like a brick" (you don't render the inside of a brick).
+- If in doubt, use *solid*='false' for maximum visibility.
+- (X3D version 4.0 draft) accessType relaxed to inputOutput in order to support animation and visualization.
 
 #### Warning
 
@@ -54,35 +56,49 @@ Setting solid true means draw only one side of polygons (backface culling on), s
 
 ### SFBool [ ] **ccw** TRUE
 
-*ccw* = counterclockwise: ordering of vertex coordinates orientation.
+*ccw* defines clockwise/counterclockwise ordering of vertex coordinates, which in turn defines front/back orientation of polygon normals according to Right-Hand Rule (RHR).
 
-#### Hint
+#### Hints
 
-- *ccw* false can reverse solid (backface culling) and normal-vector orientation.
+- A good debugging technique for problematic polygons is to try changing the value of *ccw*, which can reverse solid effects (single-sided backface culling) and normal-vector direction.
+- [Clockwise](https://en.wikipedia.org/wiki/Clockwise){:target="_blank"}
+
+#### Warning
+
+- Consistent and correct ordering of left-handed or right-handed point sequences is important throughout the coord array of point values.
 
 ### SFBool [ ] **colorPerVertex** TRUE
 
-Whether Color node color values are applied to each vertex (true) or to each polygon face (false).
+Whether Color or ColorRGBA values are applied to each point vertex (true) or to each polygon face (false).
 
-#### See Also
+#### Hint
 
 - [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
 
+#### Warnings
+
+- The provided value of IndexedQuadSet *colorPerVertex* field is ignored and always treated as true.
+- If child Color or ColorRGBA node is not provided, then geometry is rendered using corresponding Appearance and material/texture values.
+
 ### SFBool [ ] **normalPerVertex** TRUE
 
-Whether Normal node vector values are applied to each vertex (true) or to each polygon face (false).
+Whether Normal node vector values are applied to each point vertex (true) or to each polygon face (false).
+
+#### Hint
+
+- If no child Normal node is provided, the X3D browser shall automatically generate normals, using creaseAngle to determine smoothed shading across shared vertices.
 
 ### MFInt32 [ ] **index** [ ] <small>[0,∞)</small>
 
-*index* values provide order in which coordinates are applied. Order starts at index 0, commas are optional between sets. Four unique indices are defined for each quadrilateral.
+*index* values provide order in which coordinates are applied. Order starts at *index* 0, commas are optional between sets. Four unique indices are defined for each quadrilateral.
 
-#### Warning:
+#### Warning
 
 - -1 sentinel values are not allowed.
 
 ### MFNode [in, out] **attrib** [ ] <small>[X3DVertexAttributeNode]</small>
 
-Multiple contained FloatVertexAttribute nodes that can specify list of per-vertex attribute information for programmable shaders.
+Single contained FloatVertexAttribute node that can specify list of per-vertex attribute information for programmable shaders.
 
 #### Hint
 
@@ -94,7 +110,7 @@ Single contained FogCoordinate node that can specify depth parameters for fog in
 
 ### SFNode [in, out] **color** NULL <small>[X3DColorNode]</small>
 
-Single contained Color or ColorRGBA node that can specify color values applied to corresponding vertices according to colorIndex and colorPerVertex fields.
+Single contained Color or ColorRGBA node that can specify *color* values applied to corresponding vertices according to colorIndex and colorPerVertex fields.
 
 ### SFNode [in, out] **texCoord** NULL <small>[X3DTextureCoordinateNode]</small>
 
@@ -108,18 +124,31 @@ Single contained Normal node that can specify perpendicular vectors for correspo
 
 - Useful for special effects. Normal vector computation by 3D graphics hardware is quite fast so adding normals to a scene is typically unnecessary.
 
+#### Warning
+
+- *normal* vectors increase file size, typically doubling geometry definitions.
+
 ### SFNode [in, out] **coord** NULL <small>[X3DCoordinateNode]</small>
 
 Single contained Coordinate or CoordinateDouble node that can specify a list of vertex values.
 
-## Description
+## Advisories
 
 ### Hints
 
+- [Quadrilateral](https://en.wikipedia.org/wiki/Quadrilateral){:target="_blank"}
+- [Quadrilateral](https://en.wikipedia.org/wiki/Quadrilateral){:target="_blank"}
+- Color, normal and texCoord values are applied in the same order as coord values.
 - Insert a Shape node before adding geometry or Appearance.
-- You can also substitute a type-matched ProtoInstance node for contained content.
-- Include `<component name='CADGeometry' level='1'/>`
+- For advanced extensibility, authors can substitute a type-matched ProtoInstance node (with correct containerField value) for contained node content.
+- [X3D for Advanced Modeling (X3D4AM) slideset](https://x3dgraphics.com/slidesets/X3dForAdvancedModeling/ComputerAidedDesignInterchangeProfile.pdf){:target="_blank"}
+
+### Warnings
+
+- Requires X3D `profile='Full'` or else include `<component name='CADGeometry' level='1'/>`
+- Rendering characteristics are undefined if polygons are not planar.
+- Avoid self-intersecting polygon line segments, otherwise defined geometry is irregular and rendering results are undefined.
 
-## External Links
+## See Also
 
-- [X3D Specification of IndexedQuadSet](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/CADGeometry.html#IndexedQuadSet){:target="_blank"}
+- [X3D Specification of IndexedQuadSet node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/CADGeometry.html#IndexedQuadSet){:target="_blank"}

package/docs/_posts/components/CADGeometry/QuadSet.md

@@ -1,6 +1,6 @@
 ---
 title: QuadSet
-date: 2022-01-07
+date: 2023-01-07
 nav: components-CADGeometry
 categories: [components, CADGeometry]
 tags: [QuadSet, CADGeometry]
@@ -13,9 +13,9 @@ tags: [QuadSet, CADGeometry]
 
 ## Overview
 
-QuadSet is a geometry node that defines quadrilaterals. QuadSet can contain Color/ColorRGBA, Coordinate/CoordinateDouble, Normal and TextureCoordinate nodes.
+QuadSet is a geometry node that defines planar quadrilaterals. QuadSet contains a Coordinate or CoordinateDouble node, and can also contain Color or ColorRGBA, Normal and TextureCoordinate nodes.
 
-The QuadSet node belongs to the **CADGeometry** component and its default container field is *geometry.* It is available since X3D version 3.1 or later.
+The QuadSet node belongs to the **CADGeometry** component and its default container field is *geometry.* It is available from X3D version 3.1 or higher.
 
 ## Hierarchy
 
@@ -30,15 +30,21 @@ The QuadSet node belongs to the **CADGeometry** component and its default contai
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
+
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
 ### SFBool [ ] **solid** TRUE
 
-Setting solid true means draw only one side of polygons (backface culling on), setting solid false means draw both sides of polygons (backface culling off).
+Setting *solid* true means draw only one side of polygons (backface culling on), setting *solid* false means draw both sides of polygons (backface culling off).
 
-#### Hint
+#### Hints
 
-- If in doubt, use solid='false' for maximum visibility.
+- Mnemonic "this geometry is *solid* like a brick" (you don't render the inside of a brick).
+- If in doubt, use *solid*='false' for maximum visibility.
+- (X3D version 4.0 draft) accessType relaxed to inputOutput in order to support animation and visualization.
 
 #### Warning
 
@@ -46,27 +52,41 @@ Setting solid true means draw only one side of polygons (backface culling on), s
 
 ### SFBool [ ] **ccw** TRUE
 
-*ccw* = counterclockwise: ordering of vertex coordinates orientation.
+*ccw* defines clockwise/counterclockwise ordering of vertex coordinates, which in turn defines front/back orientation of polygon normals according to Right-Hand Rule (RHR).
 
-#### Hint
+#### Hints
 
-- *ccw* false can reverse solid (backface culling) and normal-vector orientation.
+- A good debugging technique for problematic polygons is to try changing the value of *ccw*, which can reverse solid effects (single-sided backface culling) and normal-vector direction.
+- [Clockwise](https://en.wikipedia.org/wiki/Clockwise){:target="_blank"}
+
+#### Warning
+
+- Consistent and correct ordering of left-handed or right-handed point sequences is important throughout the coord array of point values.
 
 ### SFBool [ ] **colorPerVertex** TRUE
 
-Whether Color node color values are applied to each vertex (true) or to each polygon face (false).
+Whether Color or ColorRGBA values are applied to each point vertex (true) or to each polygon face (false).
 
-#### See Also
+#### Hint
 
 - [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
 
+#### Warnings
+
+- The provided value of QuadSet *colorPerVertex* field is ignored and always treated as true.
+- If child Color or ColorRGBA node is not provided, then geometry is rendered using corresponding Appearance and material/texture values.
+
 ### SFBool [ ] **normalPerVertex** TRUE
 
-Whether Normal node vector values are applied to each vertex (true) or to each polygon face (false).
+Whether Normal node vector values are applied to each point vertex (true) or to each polygon face (false).
+
+#### Hint
+
+- If no child Normal node is provided, the X3D browser shall automatically generate normals, using creaseAngle to determine smoothed shading across shared vertices.
 
 ### MFNode [in, out] **attrib** [ ] <small>[X3DVertexAttributeNode]</small>
 
-Multiple contained FloatVertexAttribute nodes that can specify list of per-vertex attribute information for programmable shaders.
+Single contained FloatVertexAttribute node that can specify list of per-vertex attribute information for programmable shaders.
 
 #### Hint
 
@@ -78,7 +98,7 @@ Single contained FogCoordinate node that can specify depth parameters for fog in
 
 ### SFNode [in, out] **color** NULL <small>[X3DColorNode]</small>
 
-Single contained Color or ColorRGBA node that can specify color values applied to corresponding vertices according to colorIndex and colorPerVertex fields.
+Single contained Color or ColorRGBA node that can specify *color* values applied to corresponding vertices according to colorIndex and colorPerVertex fields.
 
 ### SFNode [in, out] **texCoord** NULL <small>[X3DTextureCoordinateNode]</small>
 
@@ -92,22 +112,34 @@ Single contained Normal node that can specify perpendicular vectors for correspo
 
 - Useful for special effects. Normal vector computation by 3D graphics hardware is quite fast so adding normals to a scene is typically unnecessary.
 
+#### Warning
+
+- *normal* vectors increase file size, typically doubling geometry definitions.
+
 ### SFNode [in, out] **coord** NULL <small>[X3DCoordinateNode]</small>
 
 Single contained Coordinate or CoordinateDouble node that can specify a list of vertex values.
 
-## Description
+## Advisories
 
 ### Hints
 
+- [Quadrilateral](https://en.wikipedia.org/wiki/Quadrilateral){:target="_blank"}
+- Color, normal and texCoord values are applied in the same order as coord values.
 - Insert a Shape node before adding geometry or Appearance.
-- You can also substitute a type-matched ProtoInstance node for contained content.
-- Include `<component name='CADGeometry' level='1'/>`
+- For advanced extensibility, authors can substitute a type-matched ProtoInstance node (with correct containerField value) for contained node content.
+- [X3D for Advanced Modeling (X3D4AM) slideset](https://x3dgraphics.com/slidesets/X3dForAdvancedModeling/ComputerAidedDesignInterchangeProfile.pdf){:target="_blank"}
+
+### Warnings
+
+- Requires X3D `profile='Full'` or else include `<component name='CADGeometry' level='1'/>`
+- Rendering characteristics are undefined if polygons are not planar.
+- Avoid self-intersecting polygon line segments, otherwise defined geometry is irregular and rendering results are undefined.
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/CADGeometry/QuadSet/QuadSet.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of QuadSet](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/CADGeometry.html#QuadSet){:target="_blank"}
+- [X3D Specification of QuadSet node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/CADGeometry.html#QuadSet){:target="_blank"}

package/docs/_posts/components/Core/MetadataBoolean.md

@@ -1,6 +1,6 @@
 ---
 title: MetadataBoolean
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Core
 categories: [components, Core]
 tags: [MetadataBoolean, Core]
@@ -13,9 +13,9 @@ tags: [MetadataBoolean, Core]
 
 ## Overview
 
-MetadataBoolean contains a typed list of values providing metadata information about its parent node. Further information about this specific Metadata node may be provided by a single child Metadata node with containerField="metadata".
+MetadataBoolean contains a typed list of values providing metadata information about its parent node. Further information about this specific Metadata* node may be provided by a single child Metadata* node with `containerField='metadata'.`
 
-The MetadataBoolean node belongs to the **Core** component and its default container field is *metadata.* It is available since X3D version 3.3 or later.
+The MetadataBoolean node belongs to the **Core** component and its default container field is *metadata.* It is available from X3D version 3.3 or higher.
 
 ## Hierarchy
 
@@ -30,41 +30,52 @@ The MetadataBoolean node belongs to the **Core** component and its default conta
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
+
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
 ### SFString [in, out] **name** ""
 
-Depending on the metadata vocabulary, the attribute name is usually required for metadata nodes.
+Depending on the metadata vocabulary, the attribute *name* is usually required for metadata nodes.
+
+#### Hints
+
+- Well-defined names can simplify design and debugging through improved author understanding.
+- [X3D Scene Authoring Hints, Naming Conventions](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions){:target="_blank"}
 
 #### Warning
 
-- Name is not included if this instance is a USE node.
+- *name* field is not included if this instance is a USE node, in order to avoid potential mismatches.
 
 ### SFString [in, out] **reference** ""
 
-*reference* to the metadata standard or definition defining this particular metadata value.
+Reference to the metadata standard or definition defining this particular metadata value.
 
 ### MFBool [in, out] **value** [ ]
 
-The value attribute is a strictly typed data array providing relevant metadata information.
+The *value* attribute is a strictly typed data array providing relevant metadata information.
 
 #### Warning
 
 - Use lower-case values ("true false") for .x3d XML encoding, and upper-case values ("TRUE FALSE") for .x3dv ClassicVRML encoding.
 
-#### Warning
+## Advisories
 
-- Use lower-case values ("true false") for .x3d XML encoding, and upper-case values ("TRUE FALSE") for .x3dv ClassicVRML encoding.
+### Hints
 
-## Description
+- Use `containerField='value'` if the parent node is MetadataSet.
+- [Each of the Metadata nodes are allowed as top-level root nodes in a scene, be sure to explicitly define `containerField='metadata'.`](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-DIS/Part01/concepts.html#Rootnodes){:target="_blank"}
+- If present, an IS statement is the first child within any other node.
+- An IS statement precedes any sibling Metadata* node, which in turn precedes any other sibling nodes.
+- Comments are not readable when a model file is loaded for viewing, but WorldInfo and Metadata* nodes are persistent and inspectable at run time.
+- [X3D for Web Authors, Chapter 15, Metadata Information](https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter15-Metadata/Chapter15-MetadataInformation.html){:target="_blank"}
 
-### Hints
+### Warning
 
-- Use containerField="value" if the parent node is MetadataSet.
-- If a metadata node is needed as a top-level root node for the scene, first insert a parent WorldInfo (or WorldInfo/MetadataSet) to contain it.
-- An IS statement precedes any sibling Metadata node, which in turn precedes any other sibling nodes.
+- Metadata nodes can only contain other Metadata nodes.
 
-## External Links
+## See Also
 
-- [X3D Specification of MetadataBoolean](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/core.html#MetadataBoolean){:target="_blank"}
-- [X3D for Web Authors, Chapter 15, Metadata Information](https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter15-Metadata/Chapter15-MetadataInformation.html){:target="_blank"}
+- [X3D Specification of MetadataBoolean node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/core.html#MetadataBoolean){:target="_blank"}

package/docs/_posts/components/Core/MetadataDouble.md

@@ -1,6 +1,6 @@
 ---
 title: MetadataDouble
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Core
 categories: [components, Core]
 tags: [MetadataDouble, Core]
@@ -13,9 +13,9 @@ tags: [MetadataDouble, Core]
 
 ## Overview
 
-MetadataDouble contains a typed list of values providing metadata information about its parent node. Further information about this specific Metadata node may be provided by a single child Metadata node with containerField="metadata".
+MetadataDouble contains a typed list of values providing metadata information about its parent node. Further information about this specific Metadata* node may be provided by a single child Metadata* node with `containerField='metadata'.`
 
-The MetadataDouble node belongs to the **Core** component and its default container field is *metadata.* It is available since X3D version 3.0 or later.
+The MetadataDouble node belongs to the **Core** component and its default container field is *metadata.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -30,38 +30,53 @@ The MetadataDouble node belongs to the **Core** component and its default contai
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
+
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
 ### SFString [in, out] **name** ""
 
-Depending on the metadata vocabulary, the attribute name is usually required for metadata nodes.
+Depending on the metadata vocabulary, the attribute *name* is usually required for metadata nodes.
+
+#### Hints
+
+- Well-defined names can simplify design and debugging through improved author understanding.
+- [X3D Scene Authoring Hints, Naming Conventions](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions){:target="_blank"}
 
 #### Warning
 
-- Name is not included if this instance is a USE node.
+- *name* field is not included if this instance is a USE node, in order to avoid potential mismatches.
 
 ### SFString [in, out] **reference** ""
 
-*reference* to the metadata standard or definition defining this particular metadata value.
+Reference to the metadata standard or definition defining this particular metadata value.
 
 ### MFDouble [in, out] **value** [ ]
 
-The value attribute is a strictly typed data array providing relevant metadata information.
+The *value* attribute is a strictly typed data array providing relevant metadata information.
 
 #### Hint
 
-- Many XML tools substitute XML character references automatically if needed (such as &amp;#38; for &amp; ampersand, or &amp;#34; for " quotation mark).
+- Many XML tools substitute XML character references for special characters automatically if needed within an attribute *value* (such as &amp;#38; for &amp; ampersand character, or &amp;#34; for " quotation-mark character).
 
-## Description
+## Advisories
 
 ### Hints
 
-- Use containerField="value" if the parent node is MetadataSet.
-- If a metadata node is needed as a top-level root node for the scene, first insert a parent WorldInfo (or WorldInfo/MetadataSet) to contain it.
-- An IS statement precedes any sibling Metadata node, which in turn precedes any other sibling nodes.
+- Use `containerField='value'` if the parent node is MetadataSet.
+- [Each of the Metadata nodes are allowed as top-level root nodes in a scene, be sure to explicitly define `containerField='metadata'.`](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-DIS/Part01/concepts.html#Rootnodes){:target="_blank"}
+- If present, an IS statement is the first child within any other node.
+- An IS statement precedes any sibling Metadata* node, which in turn precedes any other sibling nodes.
 - The choice of MetadataDouble versus MetadataFloat usually depends on the relevant tool utilizing the value, or else the relevant metadata reference defining the value.
+- Comments are not readable when a model file is loaded for viewing, but WorldInfo and Metadata* nodes are persistent and inspectable at run time.
+- [X3D for Web Authors, Chapter 15, Metadata Information](https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter15-Metadata/Chapter15-MetadataInformation.html){:target="_blank"}
 
-## External Links
+### Warning
 
-- [X3D Specification of MetadataDouble](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/core.html#MetadataDouble){:target="_blank"}
-- [X3D for Web Authors, Chapter 15, Metadata Information](https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter15-Metadata/Chapter15-MetadataInformation.html){:target="_blank"}
+- Metadata nodes can only contain other Metadata nodes.
+
+## See Also
+
+- [X3D Specification of MetadataDouble node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/core.html#MetadataDouble){:target="_blank"}

package/docs/_posts/components/Core/MetadataFloat.md

@@ -1,6 +1,6 @@
 ---
 title: MetadataFloat
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Core
 categories: [components, Core]
 tags: [MetadataFloat, Core]
@@ -13,9 +13,9 @@ tags: [MetadataFloat, Core]
 
 ## Overview
 
-MetadataFloat contains a typed list of values providing metadata information about its parent node. Further information about this specific Metadata node may be provided by a single child Metadata node with containerField="metadata".
+MetadataFloat contains a typed list of values providing metadata information about its parent node. Further information about this specific Metadata* node may be provided by a single child Metadata* node with `containerField='metadata'.`
 
-The MetadataFloat node belongs to the **Core** component and its default container field is *metadata.* It is available since X3D version 3.0 or later.
+The MetadataFloat node belongs to the **Core** component and its default container field is *metadata.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -30,38 +30,53 @@ The MetadataFloat node belongs to the **Core** component and its default contain
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
+
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
 ### SFString [in, out] **name** ""
 
-Depending on the metadata vocabulary, the attribute name is usually required for metadata nodes.
+Depending on the metadata vocabulary, the attribute *name* is usually required for metadata nodes.
+
+#### Hints
+
+- Well-defined names can simplify design and debugging through improved author understanding.
+- [X3D Scene Authoring Hints, Naming Conventions](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions){:target="_blank"}
 
 #### Warning
 
-- Name is not included if this instance is a USE node.
+- *name* field is not included if this instance is a USE node, in order to avoid potential mismatches.
 
 ### SFString [in, out] **reference** ""
 
-*reference* to the metadata standard or definition defining this particular metadata value.
+Reference to the metadata standard or definition defining this particular metadata value.
 
 ### MFFloat [in, out] **value** [ ]
 
-The value attribute is a strictly typed data array providing relevant metadata information.
+The *value* attribute is a strictly typed data array providing relevant metadata information.
 
 #### Hint
 
-- Many XML tools substitute XML character references automatically if needed (such as &amp;#38; for &amp; ampersand, or &amp;#34; for " quotation mark).
+- Many XML tools substitute XML character references for special characters automatically if needed within an attribute *value* (such as &amp;#38; for &amp; ampersand character, or &amp;#34; for " quotation-mark character).
 
-## Description
+## Advisories
 
 ### Hints
 
-- Use containerField="value" if the parent node is MetadataSet.
-- If a metadata node is needed as a top-level root node for the scene, first insert a parent WorldInfo (or WorldInfo/MetadataSet) to contain it.
-- An IS statement precedes any sibling Metadata node, which in turn precedes any other sibling nodes.
+- Use `containerField='value'` if the parent node is MetadataSet.
+- [Each of the Metadata nodes are allowed as top-level root nodes in a scene, be sure to explicitly define `containerField='metadata'.`](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-DIS/Part01/concepts.html#Rootnodes){:target="_blank"}
+- If present, an IS statement is the first child within any other node.
+- An IS statement precedes any sibling Metadata* node, which in turn precedes any other sibling nodes.
 - The choice of MetadataDouble versus MetadataFloat usually depends on the relevant tool utilizing the value, or else the relevant metadata reference defining the value.
+- Comments are not readable when a model file is loaded for viewing, but WorldInfo and Metadata* nodes are persistent and inspectable at run time.
+- [X3D for Web Authors, Chapter 15, Metadata Information](https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter15-Metadata/Chapter15-MetadataInformation.html){:target="_blank"}
 
-## External Links
+### Warning
 
-- [X3D Specification of MetadataFloat](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/core.html#MetadataFloat){:target="_blank"}
-- [X3D for Web Authors, Chapter 15, Metadata Information](https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter15-Metadata/Chapter15-MetadataInformation.html){:target="_blank"}
+- Metadata nodes can only contain other Metadata nodes.
+
+## See Also
+
+- [X3D Specification of MetadataFloat node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/core.html#MetadataFloat){:target="_blank"}