You asked "Hi Dria. Is there a ready-made page template to allow me to add new pages to the DOM reference please, in place of those red colored dead-end links?"
- We don't have a template, no, but if you're going to document new things, just copy the general structure from another page in the reference. Thanks in advance for your help! -- dria 05:15, 7 July 2006 (PDT)
DOM Reference comments
Hi, thanks for your help with the DOM reference. Please use the talk pages for your comments instead of putting them (commented out) on the reference page itself. That way, people can see your comments without going into the edit mode.
And please feel free to go ahead and fix the problems you see, after some research. --Nickolay 04:10, 10 July 2006 (PDT)
Ok, thanks Nickolay. I find it helps me to learn the DOM, by trying out small code snippets, and then adding them to the reference. Currently I use Firefox 22.214.171.124 and the FireBug extension ( https://addons.mozilla.org/firefox/1843/ ) for testing examples. Aardvark is also handy at times for studying page layout. http://karmatics.com/aardvark/ - Jabez
We've been removing that section from the paging (merging it with the Syntax section). Please don't add it back. "Parameters" is not accurate, as it's actually "parameters and return values and maybe something more", and there's no reason for it to be in a separate section. --Nickolay 11:10, 14 July 2006 (PDT)
I did wonder about that. So when I come across a parameter or return values section, shall I just move it to the syntax section?
What about methods that have a long list of parameters, such as:
what shall I do with a long list of parameters like this?
I think it goes without saying that a return value is obviously not a parameter.
- I think we should keep/move the parameters/return values/whatever in/to the Syntax section in all cases.
- (By the way, on the reference pages I edited, the actual parameters were listed first, followed by the return value description. You moved the return value to be the first thing described. I'm fine with it, just FYI in case you wondered about that too.) --Nickolay 18:13, 15 July 2006 (PDT)
OK thanks Nickolay. As we read from left to right, I think it makes sense to keep the return value and the parameter description(s) in the same order as they appear in the declaration. Jabez
DOM Reference discussion
Hi, you've been actively editing the DOM reference for a while, so you might be interested in discussion about it on dev-mdc: --Nickolay 05:57, 28 August 2006 (PDT)
Update - I think there needs to be a detailed and carefully thought out plan for a skeleton structure of how the newly re-organised DOM documentation will be organised. This would give the contributors some sort of guidelines and framework to code in. Something like a top down tree structure - similar to a detailed list of contents should do. This could start at the MDC homepage and then cover all of the documentation.
As far as interfaces go, for someone learning web development, they don't mean alot to me, although they are probably quite important to others. I'm far more concerned about what DOM objects are available, and what properties, methods and events they offer a web designer interested in DHTML. All I need is a simple example to illustrate how a particular property, method, or event can be used in my website code. Quote from http://www.w3schools.com,
"Never increase, beyond what is necessary, the number of entities required to explain anything" -- William of Ockham (1285-1349).
The DOM:style documentation is a bit vague to say the least, and I'm not even sure if this is actually needed. I'm trying to think of a way to document the CSS style properties, without having multiple instances of the documents under different titles.
For others that want to manipulate style values through the DOM dynamically with DHTML, maybe some sort of introducion on how to manipulate a page element's style values would be helpfull.
This could also cover the following objects:
- style element object - which represents the <style> tag in an (x)html document.
- styleSheet object - a member of the styleSheets array
- cssRule object - a member of the cssRules array
- style object - a property of an (x)html element