2 ms·
You're right in that the old docs had really bad searching. That's much improved in the new docs. I might be different. I came to learn jQuery through the ra
by pak 16y ago
You're right in that the old docs had really bad searching. That's much improved in the new docs.
I might be different. I came to learn jQuery through the raw docs, not through tutorials, and found that the old docs' organization was more friendly for casual browsing & exploration, and the new is more amenable to API lookup ("I already know the name of the method").
For example, compare the selectors page:
New: http://api.jquery.com/category/selectors/ http://api.jquery.com/category/selectors/
Old: http://web.archive.org/web/20080516171346/docs.jquery.com/Selectors http://web.archive.org/web/20080516171346/docs.jquery.com/Se...
(The CSS is very broken on the archive--) but you can see that you used to have it organized functionally, not alphabetically, which was great for me as a learner to see at a glance the different axes of capability for jQuery's selector engine, instead of a alphabetical mash of selector operators, some titled by the operator, others by a description. If I didn't already know CSS thoroughly, reading your selector operator list now would be very disorienting.
I have to say jQuery and its community is amazing, without it QuickFuse (http://quickfuseapps.com http://quickfuseapps.com) would not have been possible. But one of its strengths was being able to be grokked so quickly by newcomers, and I was a bit disheartened to see the docs stray away from a introductory format more in favor of a reference format. It's a bit more intimidating to the newcomer to have to wade through categorical tagged lists of methods with brief descriptions, instead of a human-organized page on each aspect of the jQuery object that presents the methods in a sensible order.