x_ite 8.8.7 → 8.9.0

package/docs/_posts/components/RigidBodyPhysics/SliderJoint.md

@@ -1,6 +1,6 @@
 ---
 title: SliderJoint
-date: 2022-01-07
+date: 2023-01-07
 nav: components-RigidBodyPhysics
 categories: [components, RigidBodyPhysics]
 tags: [SliderJoint, RigidBodyPhysics]
@@ -15,7 +15,7 @@ tags: [SliderJoint, RigidBodyPhysics]
 
 SliderJoint constrains all movement between body1 and body2 along a single axis. Contains two RigidBody nodes (containerField values body1, body2).
 
-The SliderJoint node belongs to the **RigidBodyPhysics** component and its default container field is *joints.* It is available since X3D version 3.2 or later.
+The SliderJoint node belongs to the **RigidBodyPhysics** component and its default container field is *joints.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -29,7 +29,11 @@ The SliderJoint node belongs to the **RigidBodyPhysics** component and its defau
 
 ### 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"}
 
 ### MFString [in, out] **forceOutput** "NONE" <small>["ALL", "NONE", ...]</small>
 
@@ -45,7 +49,7 @@ Metadata are not part of the X3D world and not interpreted by the X3D browser, b
 
 #### Hint
 
-- If (minSeparation is less than maxSeparation) then no stop is effective.
+- If (*minSeparation* is less than maxSeparation) then no stop is effective.
 
 ### SFFloat [in, out] **maxSeparation** 1 <small>[0,∞)</small>
 
@@ -53,11 +57,11 @@ Metadata are not part of the X3D world and not interpreted by the X3D browser, b
 
 #### Hint
 
-- If (minSeparation is less than maxSeparation) then no stop is effective.
+- If (minSeparation is less than *maxSeparation*) then no stop is effective.
 
 ### SFFloat [in, out] **sliderForce** 0 <small>[-∞,∞)</small> <small class="red">not supported</small>
 
-Input/Output field sliderForce.
+*sliderForce* value is used to apply a force (specified in force base units) along the axis of the slider in equal and opposite directions to the two bodies. A positive value applies a force such that the two bodies accelerate away from each other, while a negative value applies a force such that the two bodies accelerate toward each other.
 
 ### SFFloat [in, out] **stopBounce** 0 <small>[0,1]</small> <small class="red">not supported</small>
 
@@ -77,21 +81,29 @@ Input/Output field sliderForce.
 
 ### SFFloat [out] **separation** <small class="red">not supported</small>
 
-*separation* indicates final separation distance between the two bodies.
+*separation* indicates final *separation* distance between the two bodies.
+
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
 
 ### SFFloat [out] **separationRate** <small class="red">not supported</small>
 
 *separationRate* indicates change in separation distance over time between the two bodies.
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### SFNode [in, out] **body1** NULL <small>[RigidBody]</small>
 
-Input/Output field body1.
+The *body1* and body2 fields indicate the two RigidBody nodes connected by this joint.
 
 ### SFNode [in, out] **body2** NULL <small>[RigidBody]</small>
 
-Input/Output field body2.
+The body1 and *body2* fields indicate the two RigidBody nodes connected by this joint.
 
-## Description
+## Advisories
 
 ### Hint
 
@@ -101,6 +113,6 @@ Input/Output field body2.
 
 <x3d-canvas src="https://create3000.github.io/media/examples/RigidBodyPhysics/SliderJoint/SliderJoint.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of SliderJoint](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/rigidBodyPhysics.html#SliderJoint){:target="_blank"}
+- [X3D Specification of SliderJoint node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/rigidBodyPhysics.html#SliderJoint){:target="_blank"}

package/docs/_posts/components/RigidBodyPhysics/UniversalJoint.md

@@ -1,6 +1,6 @@
 ---
 title: UniversalJoint
-date: 2022-01-07
+date: 2023-01-07
 nav: components-RigidBodyPhysics
 categories: [components, RigidBodyPhysics]
 tags: [UniversalJoint, RigidBodyPhysics]
@@ -15,7 +15,7 @@ tags: [UniversalJoint, RigidBodyPhysics]
 
 UniversalJoint is like a BallJoint that constrains an extra degree of rotational freedom. Contains two RigidBody nodes (containerField values body1, body2).
 
-The UniversalJoint node belongs to the **RigidBodyPhysics** component and its default container field is *joints.* It is available since X3D version 3.2 or later.
+The UniversalJoint node belongs to the **RigidBodyPhysics** component and its default container field is *joints.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -29,7 +29,11 @@ The UniversalJoint node belongs to the **RigidBodyPhysics** component and its de
 
 ### 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"}
 
 ### MFString [in, out] **forceOutput** "NONE" <small>["ALL", "NONE", ...]</small>
 
@@ -45,7 +49,7 @@ Metadata are not part of the X3D world and not interpreted by the X3D browser, b
 
 #### Hint
 
-- 0 0 0 means motor disabled.
+- 0 0 0 means motor disabled about this axis.
 
 ### SFVec3f [in, out] **axis2** 0 0 0 <small>(-∞,∞)</small>
 
@@ -53,11 +57,15 @@ Metadata are not part of the X3D world and not interpreted by the X3D browser, b
 
 #### Hint
 
-- 0 0 0 means motor disabled.
+- 0 0 0 means motor disabled about this axis.
 
 ### SFFloat [in, out] **stop1Bounce** 0 <small>[0,1]</small>
 
-Input/Output field stop1Bounce.
+*stop1Bounce* is velocity factor for bounce back once stop point is reached.
+
+#### Hint
+
+- 0 means no bounce, 1 means return velocity matches.
 
 ### SFFloat [in, out] **stop2Bounce** 0 <small>[0,1]</small>
 
@@ -85,35 +93,35 @@ Input/Output field stop1Bounce.
 
 ### SFVec3f [out] **body1Axis**
 
-Output field body1Axis.
+Output field *body1Axis*.
 
 ### SFVec3f [out] **body2Axis**
 
-Output field body2Axis.
+Output field *body2Axis*.
 
 ### SFVec3f [out] **body1AnchorPoint**
 
-Output field body1AnchorPoint.
+Output field *body1AnchorPoint*.
 
 ### SFVec3f [out] **body2AnchorPoint**
 
-Output field body2AnchorPoint.
+Output field *body2AnchorPoint*.
 
 ### SFNode [in, out] **body1** NULL <small>[RigidBody]</small>
 
-Input/Output field body1.
+The *body1* and body2 fields indicate the two RigidBody nodes connected by this joint.
 
 ### SFNode [in, out] **body2** NULL <small>[RigidBody]</small>
 
-Input/Output field body2.
+The body1 and *body2* fields indicate the two RigidBody nodes connected by this joint.
 
-## Description
+## Advisories
 
 ### Hints
 
 - Useful in combination with BallJoint.
 - RigidBodyPhysics component, level 2.
 
-## External Links
+## See Also
 
-- [X3D Specification of UniversalJoint](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/rigidBodyPhysics.html#UniversalJoint){:target="_blank"}
+- [X3D Specification of UniversalJoint node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/rigidBodyPhysics.html#UniversalJoint){:target="_blank"}

package/docs/_posts/components/Scripting/Script.md

@@ -1,6 +1,6 @@
 ---
 title: Script
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Scripting
 categories: [components, Scripting]
 tags: [Script, Scripting]
@@ -13,9 +13,9 @@ tags: [Script, Scripting]
 
 ## Overview
 
-Script provides programmed behavior for a scene. Define the script interface with `<field>` elements. Scripting code is embedded in a child CDATA node or (deprecated) in the url field. Optionally supported programming languages: ECMAScript (JavaScript) and (via url to a myNode.class file) Java.
+Script contains author-programmed event behaviors for a scene. Define the script input-output event interface by including \<field/\> elements. Scripting code is embedded in a child CDATA node or (deprecated) in the url field. Optionally supported programming languages are ECMAScript (JavaScript) and Java (via url to a myNode.class file).
 
-The Script node belongs to the **Scripting** component and its default container field is *children.* It is available since X3D version 2.0 or later.
+The Script node belongs to the **Scripting** component and its default container field is *children.* It is available from X3D version 2.0 or higher.
 
 ## Hierarchy
 
@@ -32,7 +32,11 @@ The Script node belongs to the **Scripting** component and its default container
 
 ### 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] **description** ""
 
@@ -40,34 +44,38 @@ Author-provided prose that describes intended purpose of the url asset.
 
 #### Hint
 
-- Many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &amp;#38; for & ampersand character, or &amp;#34; for " quotation-mark character).
+- 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).
 
 ### SFBool [in, out] **load** TRUE
 
-*load*=true means load immediately, load=false means defer loading or else unload a previously loaded asset.
+*load*=true means *load* immediately, *load*=false means defer loading or else unload a previously loaded scene.
 
 #### Hints
 
-- Allows author to design when ImageTextureAtlas loading occurs via user interaction, event chains or scripting.
+- Allows author to design when Inline loading occurs via user interaction, event chains or scripting.
 - Use a separate LoadSensor node to detect when loading is complete.
 
 ### MFString [in, out] **url** [ ] <small>[URI]</small>
 
-Points to a script file url. Also (as deprecated alternative to CDATA block) can contain ecmascript: source as a quoted SFString within the url array.
+List of address links for runnable script files.
 
-#### Hint
+#### Hints
 
-- If Script contains both external url reference and internal CDATA source then external url takes precedence, but will fall back to contained CDATA source if no external script is found.
+- Embedded ecmascript: source can also be contained in the sourceCode pseudo-field without escape characters, equivalent to last entry in the *url* list, when using other API codebases and file encodings.
+- Browsers are not required to support any particular scripting language, but ECMAScript (JavaScript) is widely supported.
+- Equivalent script code written in multiple programming languages can be provided for portability, the first runnable version is chosen at run time.
+- [X3D Scene Authoring Hints, Scripts](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Scripts){:target="_blank"}
+- If both *url* field and CDATA section are provided simultaneously, the *url* field is processed first. This approach allows utilization of update modifications or live queries in external scripts, while still providing reliable script source as a fallback alternative within the model itself.
+- [X3D XML Encoding, 4.3.13 Encapsulating Script node code](https://www.web3d.org/documents/specifications/19776-1/V3.3/Part01/concepts.html#EncapsulatingScriptNodeCode){:target="_blank"}
+- MFString arrays can have multiple values, so separate each individual string by quote marks "https://www.web3d.org" "https://www.web3d.org/about" "etc."
+- Alternative XML encoding for quotation mark " is &amp;quot; (which is an example of a character entity).
+- Can replace embedded blank(s) in *url* queries with %20 for each blank character.
+- [X3D Scene Authoring Hints, urls](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#urls){:target="_blank"}
 
 #### Warnings
 
-- Do not use the ecmascript: protocol prefix within external script files. Replace javascript: or vrmlscript: protocol prefix with ecmascript: for source code embedded within an X3D scene.
-
-#### See Also
-
-- [ECMAScript is the ISO standard version of JavaScript.](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#JavaScript){:target="_blank"}
-- [VrmlScript was a subset of JavaScript originally proposed for use with VRML 97.](https://www.bitmanagement.com/developer/spec/vrmlscript/vrmlscript.html){:target="_blank"}
-- [X3D Scene Authoring Hints, urls](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#urls){:target="_blank"}
+- Source code can be placed in *url* attribute but may be unparsable due to escaping of special characters and elimination of line breaks (causing comments to nullify follow-on code). Use contained CDATA section instead for embedding source code.
+- Strictly match directory and filename capitalization for http links! This is important for portability. Some operating systems are forgiving of capitalization mismatches, but http/https *url* addresses and paths in Unix-based operating systems are all case sensitive and intolerant of uppercase/lowercase mismatches.
 
 ### SFTime [in, out] **autoRefresh** 0 <small>[0,∞)</small>
 
@@ -96,28 +104,36 @@ Points to a script file url. Also (as deprecated alternative to CDATA block) can
 
 ### SFBool [ ] **directOutput** FALSE
 
-Set directOutput true if Script has field reference(s) of type SFNode/MFNode, and also uses direct access to modify attributes of a referenced node in the Scene.
+Set *directOutput* true if Script has field reference(s) of type SFNode/MFNode, and also uses direct access to modify attributes of a referenced node in the Scene.
 
 #### Hints
 
-- Set directOutput true if Script dynamically establishes or breaks ROUTEs. DirectOutput is a browser hint to avoid overoptimizing referenced nodes, since the Script may change their attribute values without ROUTEd events. DirectOutput false means Script cannot modify referenced nodes or change ROUTEs.
+- Set *directOutput* true if Script dynamically establishes or breaks ROUTEs.
+- *directOutput* is a browser hint to avoid overoptimizing referenced nodes, since a Script might directly change attribute values in referenced SFNode/MFNode fields, without a ROUTE connecting output events.
+- *directOutput* false means Script cannot modify referenced nodes or change ROUTEs.
 
 ### SFBool [ ] **mustEvaluate** FALSE
 
-If mustEvaluate false, then browser may delay sending input events to Script until outputs are needed. If mustEvaluate true, then Script must receive input events immediately without browser delays.
+If *mustEvaluate* false, then the X3D player may delay sending input events to Script until output events are needed. If *mustEvaluate* true, then Script must receive input events immediately without any event-aggregation delays.
 
 #### Hint
 
-- Set mustEvaluate true when sending/receiving values via the network.
+- Set *mustEvaluate* true when sending/receiving values via the network.
 
-## Description
+## Advisories
 
 ### Hints
 
-- Insert a CDATA node to contain source code embedded within an X3D scene.
-- CDATA blocks can protect literal characters (such as &amp; '<' and '>') in source code from unintended escape-character modifications by XML parsers.
+- Insert an XML Character Data (CDATA) block within the Script node to contain source code embedded within an X3D scene, avoiding the need for escape characters.
+- A contained XML Character Data (CDATA) block for source code protects whitespace, line breaks, and literal characters (such as &amp; for ampersand character, \< for less-than-sign character, and \> for greater-than-sign character) from unintended escape-character modifications by XML parsers.
+- [X3D Scene Authoring Hints, Scripts](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Scripts){:target="_blank"}
+- [Apply `containerField='watchList'` when parent node is LoadSensor.ECMAScript-262 specification](http://www.ecma-international.org/publications/standards/Ecma-262.htm){:target="_blank"}
+- Embedded ecmascript: source can also be contained in the sourceCode pseudo-field without escape characters, equivalent to last entry in the url list, when using other API codebases and file encodings.
 
-## External Links
+### Warning
 
-- [X3D Specification of Script](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/scripting.html#Script){:target="_blank"}
-- [X3D Scene Authoring Hints, Scripts](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Scripts){:target="_blank"}
+- Strict order is required for contained constructs: first field declarations (if any), then IS/connect statements (if any), and finally CDATA source-code block.
+
+## See Also
+
+- [X3D Specification of Script node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/scripting.html#Script){:target="_blank"}

package/docs/_posts/components/Shaders/ComposedShader.md

@@ -1,6 +1,6 @@
 ---
 title: ComposedShader
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Shaders
 categories: [components, Shaders]
 tags: [ComposedShader, Shaders]
@@ -15,7 +15,7 @@ tags: [ComposedShader, Shaders]
 
 ComposedShader defines a shader where the individual source files are assembled from contained ShaderPart program sections. All access to shading capabilities is defined through a single interface that applies to all parts.
 
-The ComposedShader node belongs to the **Shaders** component and its default container field is *shaders.* It is available since X3D version 3.0 or later.
+The ComposedShader node belongs to the **Shaders** component and its default container field is *shaders.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -32,50 +32,63 @@ The ComposedShader node belongs to the **Shaders** component and its default con
 
 ### 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 [in] **activate**
 
-*activate* forces the shader to activate the contained objects.
+*activate* forces the shader to *activate* the contained objects.
+
+#### Warning
+
+- It is an error to define this transient inputOnly field in an X3D file, instead only use it a destination for ROUTE events.
 
 ### SFBool [out] **isSelected**
 
 *isSelected* indicates this shader instance is selected for use by browser
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### SFBool [out] **isValid**
 
 *isValid* indicates whether current shader objects can be run as a shader program.
 
-### SFString [ ] **language** "" <small>["Cg"|"GLSL"|"HLSL"|...]</small>
+#### Warning
 
-The language field indicates to the X3D player which shading language is used. The language field may be used to optionally determine the language type if no MIME-type information is available.
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
 
-#### Hint
+### SFString [ ] **language** "" <small>["Cg"|"GLSL"|"HLSL"|...]</small>
 
-- Recognized values include "CG" "GLSL" "HLSL" "FX"
+The *language* field indicates to the X3D player which shading *language* is used. The *language* field may be used to optionally determine the *language* type if no MIME-type information is available.
 
-#### See Also
+#### Hint
 
-- [Relates to Internationalization (i18n)](https://www.w3.org/standards/webdesign/i18n){:target="_blank"}
+- Recognized values include "Cg" "GLSL" "HLSL".
 
 ### MFNode [in, out] **parts** [ ] <small>[ShaderPart]</small>
 
-Input/Output field parts.
+ComposedShader can contain multiple ShaderPart nodes in the *parts* field.
 
-## Description
+## Advisories
 
-### Hint
+### Hints
 
-- ComposedShader contains field definitions, IS/connect, and `<ShaderPart containerField='parts'/>` nodes.
+- ComposedShader contains field declarations and then corresponding IS/connect statements (if any), followed by \<ShaderPart `containerField='parts'/>` nodes.
+- Apply default `containerField='shaders'` when parent node is Appearance.
 
 ### Warning
 
-- ComposedShader can contain field declarations, but no CDATA section of plain-text source code. All source programs are contained in child ShaderPart nodes.
+- ComposedShader does not contain CDATA section of plain-text source code. All source programs are contained in child ShaderPart nodes.
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Shaders/ComposedShader/ComposedShader.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of ComposedShader](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shaders.html#ComposedShader){:target="_blank"}
+- [X3D Specification of ComposedShader node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shaders.html#ComposedShader){:target="_blank"}

package/docs/_posts/components/Shaders/FloatVertexAttribute.md

@@ -1,6 +1,6 @@
 ---
 title: FloatVertexAttribute
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Shaders
 categories: [components, Shaders]
 tags: [FloatVertexAttribute, Shaders]
@@ -15,7 +15,7 @@ tags: [FloatVertexAttribute, Shaders]
 
 FloatVertexAttribute defines a set of per-vertex single-precision floating-point attributes.
 
-The FloatVertexAttribute node belongs to the **Shaders** component and its default container field is *attrib.* It is available since X3D version 3.0 or later.
+The FloatVertexAttribute node belongs to the **Shaders** component and its default container field is *attrib.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -30,15 +30,24 @@ The FloatVertexAttribute node belongs to the **Shaders** component and its defau
 
 ### 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 [ ] **name** ""
 
-Required name for this particular VertexAttribute instance.
+Required *name* for this particular VertexAttribute instance.
+
+#### 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 specified if this instance is a USE node.
+- *name* is not specified if this instance is a USE node.
 
 ### SFInt32 [ ] **numComponents** 4 <small>[1..4]</small>
 
@@ -46,7 +55,7 @@ Required name for this particular VertexAttribute instance.
 
 #### Hint
 
-- The length of the value field shall be a multiple of numComponents.
+- The length of the value field shall be a multiple of *numComponents*.
 
 ### MFFloat [in, out] **value** [ ] <small>(-∞,∞)</small>
 
@@ -54,12 +63,12 @@ Required name for this particular VertexAttribute instance.
 
 #### Hint
 
-- The length of the value field shall be a multiple of numComponents.
+- The length of the *value* field shall be a multiple of numComponents.
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Shaders/FloatVertexAttribute/FloatVertexAttribute.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of FloatVertexAttribute](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shaders.html#FloatVertexAttribute){:target="_blank"}
+- [X3D Specification of FloatVertexAttribute node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shaders.html#FloatVertexAttribute){:target="_blank"}

package/docs/_posts/components/Shaders/Matrix3VertexAttribute.md

@@ -1,6 +1,6 @@
 ---
 title: Matrix3VertexAttribute
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Shaders
 categories: [components, Shaders]
 tags: [Matrix3VertexAttribute, Shaders]
@@ -15,7 +15,7 @@ tags: [Matrix3VertexAttribute, Shaders]
 
 Matrix3VertexAttribute defines a set of per-vertex 3x3 matrix attributes.
 
-The Matrix3VertexAttribute node belongs to the **Shaders** component and its default container field is *attrib.* It is available since X3D version 3.0 or later.
+The Matrix3VertexAttribute node belongs to the **Shaders** component and its default container field is *attrib.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -30,15 +30,24 @@ The Matrix3VertexAttribute node belongs to the **Shaders** component and its def
 
 ### 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 [ ] **name** ""
 
-Required name for this particular VertexAttribute instance.
+Required *name* for this particular VertexAttribute instance.
+
+#### 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 specified if this instance is a USE node.
+- *name* is not specified if this instance is a USE node.
 
 ### MFMatrix3f [in, out] **value** [ ] <small>(-∞,∞)</small>
 
@@ -46,8 +55,8 @@ Required name for this particular VertexAttribute instance.
 
 #### Hint
 
-- The length of the value field shall be a multiple of numComponents.
+- The length of the *value* field shall be a multiple of numComponents.
 
-## External Links
+## See Also
 
-- [X3D Specification of Matrix3VertexAttribute](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shaders.html#Matrix3VertexAttribute){:target="_blank"}
+- [X3D Specification of Matrix3VertexAttribute node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shaders.html#Matrix3VertexAttribute){:target="_blank"}

package/docs/_posts/components/Shaders/Matrix4VertexAttribute.md

@@ -1,6 +1,6 @@
 ---
 title: Matrix4VertexAttribute
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Shaders
 categories: [components, Shaders]
 tags: [Matrix4VertexAttribute, Shaders]
@@ -15,7 +15,7 @@ tags: [Matrix4VertexAttribute, Shaders]
 
 Matrix4VertexAttribute defines a set of per-vertex 4x4 matrix attributes.
 
-The Matrix4VertexAttribute node belongs to the **Shaders** component and its default container field is *attrib.* It is available since X3D version 3.0 or later.
+The Matrix4VertexAttribute node belongs to the **Shaders** component and its default container field is *attrib.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -30,15 +30,24 @@ The Matrix4VertexAttribute node belongs to the **Shaders** component and its def
 
 ### 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 [ ] **name** ""
 
-Required name for this particular VertexAttribute instance.
+Required *name* for this particular VertexAttribute instance.
+
+#### 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 specified if this instance is a USE node.
+- *name* is not specified if this instance is a USE node.
 
 ### MFMatrix4f [in, out] **value** [ ] <small>(-∞,∞)</small>
 
@@ -46,8 +55,8 @@ Required name for this particular VertexAttribute instance.
 
 #### Hint
 
-- The length of the value field shall be a multiple of numComponents.
+- The length of the *value* field shall be a multiple of numComponents.
 
-## External Links
+## See Also
 
-- [X3D Specification of Matrix4VertexAttribute](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shaders.html#Matrix4VertexAttribute){:target="_blank"}
+- [X3D Specification of Matrix4VertexAttribute node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shaders.html#Matrix4VertexAttribute){:target="_blank"}