[jQuery] Brand-new user: Viwepoint

[jQuery] Brand-new user: Viwepoint


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