> 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. You can't expect the changes to happen if you don't make them happen. Unless, of course, you're willing to hire someone to spend time writing documentation (as the Rails community did). Which part of editing the page confuses you? You click the "Edit" link, if you don't have an account, you create one, and you tweak the text where appropriate. If you have any questions, please bring it up on the jQuery Docs list: http://groups.google.com/group/jquery-docs --John
