[x3d-public] L.3.1 Re: Annex L HTML authoring guidelines for X3D4; naming Script versus X3DScript (combined)

[Don Brutzman]

Thank you for extra-inning review

On 1/28/2021 2:58 PM, Andreas Plesch wrote:
> 
> Hi Don,
> 
> Thank you much for consolidating and digesting these comments on Annex
> L. I think I agree with all your responses. Please let me know if you
> have additional questions after discussions with Dick and others.
> 
> Let me complete my review with minor comments on sections L 4.1 and L .4.2
> 
> L.4.2 JavaScript/ECMAScript considerations
> 
> Only a suggestion since sharing of the JS engine is mentioned: JS
> allows defining of variables with a global scope inside of functions.
> If X3D script node has a script which has such global variables (since
> the original author did not anticipate sharing of that global scope
> with anything else) it may lead to unexpected behaviour in case other
> scripts use the same variables. So it may be worthwhile to add a
> sentence recommending to avoid using the global scope in X3D scripts
> such as
> "It is recommended that authors of X3D script nodes avoid use of the
> global scope."

How's this, appended to last paragraph:

"To aid portability and avoid unintended overloading of variable references, it is good practice for X3D Script authors to avoid the use of variables with global scope."

> L.4.3 User focus considerations
> 
> Hm, sorry, nothing constructive comes to mind.
> 
> All the best,
> 
> -Andreas


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