[jQuery] Documentation getting stale, messy?
Hi
I don't want to bring anyone down but it seems that jQuery doco is
getting a bit stale and messy. Is that fair? I would update it myself
but I don't think I have the knowledge of the code to do so.
At the moment I want to zoom an image smoothly to X %. I don't know
whether to use .animate() or .effect() or a plugin and my choice is
being influenced by levels of doco available, rather than what is the
most effective solution, which of course sucks. For example, do I
start here:
http://docs.jquery.com/Effects
or here
http://docs.jquery.com/UI/Effects
I've been using jQuery for a while and it seems a lot of the methods
in the main library that relate to effects or widgets are still there
despite the introduction of jQuery UI. This seems like duplication to
me, which is confusing. I understand this is probably due to a medium-
length plan to distinguish between jQuery and jQuery UI however in the
middle of this 'plan' things are confusing!
Also a lot of the new jQuery UI widgets, which could be superb, seem
to be poorly documented if they are documented at all. Many pages
refer to old plugin doco such as that for dimensions and easing:
http://docs.jquery.com/Plugins/dimensions
http://docs.jquery.com/UI/Effects/AdvancedEasing
because the plugin code has been integrated. So now it seems we have
at least three categories of documentation:
1. Main library
2. Ex-plugins now in Main library
3. UI library
it's also not clear whether UI library doco should be broken into
4. UI Widgets
5. UI Effects
Perhaps if Mr Resig or someone else has some time I can help clean
things up? (always happy to put my 'money' where my mouth is)
Paul