Thomas et al,
Unless you already use some JSEditor, it would be worth trying this one -
JSEclipse:
Mini Review: http://getahead.ltd.uk/blog/joe/2005/09/27/1127804875944.html
Download: http://www.interaktonline.com/Products/Eclipse/JSEclipse/Overview/
>From the review:
"Another example of it grokking Javascript much better than the Eclipse WTP
Javascript editor is how it understands prototype.js. Sam doesn''t hold
back from exploiting Javascript features, and JSEclipse keeps up with him better
than any other Javascript tool I''ve seen: The outline right shows it
correctly finding the things that prototype.js declares. The WTP editor makes a
right mess of this."
Thank you,
Mandy.
p.s. Maybe it will help you in documentation too :)