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

[Andreas Plesch]

See below.

On Sat, Jan 30, 2021 at 5:14 PM Don Brutzman <brutzman at nps.edu> wrote:
>
> 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."

Perfect !

>
> > 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



-- 
Andreas Plesch
Waltham, MA 02453