There actually is a google groups dedicated to just that topic. http://groups.google.com/group/jquery-docs?hl=en
I have similar concerns as you. I think it will come together, but often with open source projects, the docs have peaks and valleys over time in regards to comprehensiveness, accuracy and usefulness. It might be in a valley, but a peak is on the way. I know Tane Piper is looking for help on the project. Everyone is encouraged (more than that) to chip in. Glen On 9/28/07, george.gsgd <[EMAIL PROTECTED]> wrote: > > > So what's going on with this? Whilst I know it's a huge job and takes > time, the current docs are just plain inadequate. It used to be so > much better. And there's no linking between related functions. I > realise it's a wiki, but there's no information on how to go about > editing it and it's all so convoluted I don't even know where to > start... > > Take .parent() as an example: > > "Get a set of elements containing the unique parents of the matched > set of elements." > > Does that mean all the parents of all the objects, or just the direct > parent? (The latter I _think_). I realise it's hard to get this stuff > right, but there's a lot of ambiguity there, and I just wonder who's > doing anything about it? > > Also: > "You may use an optional expression to filter the set of parent > elements that will match." > > What info are you going to give me about how to do that, Oh I see: > "Arguments: > expr (Optional) String > An expression to filter the parents with." > > I can give it a 'string'... very useful. > > Then there's the 'demo' - What exactly is it supposed to show, I have > no idea what it's done. > > Plus, where's the links to similar functions .parents() .children()? > > Sorry to sound like I'm bitching, I love jQuery, I'm a strong > evangelist of it, it just seems such a shame that the changes to the > documentation don't really seem to be improvements at all. > >
