Re: appendChild

On Mar 2, 10:28 am, Boris Zbarsky <[email protected]> wrote:
> Boris Zbarsky wrote:
> > Neither one affects appendChild behavior in terms of whether the script
> > executes; all that's affected is whether the executing script gets
> > XPCNativeWrapper automation.  This is relevant only to chrome documents,
> > of course.
>
> And we _do_ probably want to document this in the documentation that
> discusses XPCNativeWrapper automation, or something.
>
> It might be good if bugs always included a summary of what the patch
> does.  That would probably help the documentation work a good bit.
> Eric, please feel free to point out cases when a bug asks for
> documentation and doesn't have such a summary?

I've been doing that lately when it wasn't reasonably clear what was
needed.  This particular change seemed obvious, although apparently it
wasn't. Because the bug specifically mentioned cases that had
incorrect behavior, I assumed those cases were all fixed as described,
and that's what I documented.  I'll try to do a better job of double-
checking those things going forward.

I'd appreciate it if you could revise the documentation in question,
as I'm actually more unclear now than ever as to what needs to be
done. :)

Eric Shepherd
Developer Documentation Lead
Mozilla Corporation
http://www.bitstampede.com/