Hi Cherry, as you noted, jquery is an opensource project so user contributions are desired, and the doc is a wiki. Feel free to register and contribute, modify and add what you think a newbie should need. And if you are not sure, just do it, send the link to the list and have a subject like "doc updated: please review <function name>". The process is very simple so don't be afraid!
Cheers, Alexandre On Feb 2, 2008 1:40 AM, [EMAIL PROTECTED] <[EMAIL PROTECTED]> wrote: > > I couldn't find anywhere to submit feedback on the Wiki, so I figured > this must be the best place. > > I've been using jQuery for all of 36 hours now ... and I have some > comments/suggestions: > First of all, I'd like let this group know how valuable you are! > Whilst trying to learn about jQuery, I would have been totally sunk > without you. Which leads me to my remarks (I hope somebody's > listening). > > Although jQuery is the best documented & supported of today's 'new > wave' Javascript platforms, documentation for newbies is - well, > hopeless. Most of my 36 hours have been spent, frustratingly, > following up Google search results (a very few of which were useful) > on queries that should have been readily answered within jQuery's own > documentation. > > I should explain that I'm not new to Javascript - I can, reluctantly, > write my own scripts; however, it's not my strength. Imo, there should > be a comprehensive reference to jQuery's syntax & idiosyncracies. I'm > finding that, when I know roughly how to write code for the result I > want, there is no guide as to how jQuery would want it phrased. Best > of all would be a straightforward: "Result you want -> How to get > there" guide within the Wiki. > > Not everybody wants to launch straight into all-expanding, singing, > dancing & rotating slideshows! Currently there's little guidance for > those of us who actually want to *learn* this thing, and practically > none for simple functions that I could have written myself (however > clumsily) in a tenth of the time. Example: Replace text with an image. > Best done with Javascript, making it ideal for accessibility/search > purposes. No documentation on this with jQuery. > > Too much of the available guidance has been (understandably) provided > by enthusiasts, whose preference for Javascript over semantically > corrrect html is all too evident. CSS should *never* be written > inline, guys! Even after I found out how to overcome this, nobody told > me "background-image" has to be renamed "backgroundImage". See what I > mean?? > > Finally: The Wiki itself keeps crashing my browser. This happens on > the example pages, regularly. As it happens only on Wiki and sub-Wiki > pages, I've persuaded myself the problem lies within jQuery's Wiki, > not the code itself. But it doesn't instil confidence! > > Please would you aim for a documentation as thorough as > http://www.php.net/manual/en/ > ? OK, php.net took 15 years or so to build - but they were on virgin > ground, and now you can copy from their experience ;) > > Don't think I'm dissing you all! I have high hopes of jQuery, and > really do appreciate the assistance that is available!! Just thought a > fresher's view might come in useful .... Back to the text-replacement > thingy for me, then! > > Cheers, > Cherry > -- Alexandre Plennevaux LAb[au] http://www.lab-au.com