And this is DED|Chain, written , and concerning JavaScript and the DOM
Comments
I think my post got deleted when I signed in via OpenID. To summarize:
"Transitioning" tutorials would definitely be useful. We currently list them here as being desired for the jQuery site:
http://docs.jquery.com/Main_Page/Desired
We've held off on them, for now, simply because we tend to feel that a tutorial of that nature would come off as being narcissistic, and possibly be in poor taste. Which is interesting, because they would absolutely be very useful to a large number of people. We've been trying to "play well with others" and we're mixed as to if those tutorials fit in with this strategy.
Additionally, the "transitioning" tutorials can absolutely help users better understand the philosophy of a particular library. Generally, libraries tend to be built and focused very differently, so helping a user understand the differences, better, would be ideal.
John: it didn't get deleted, it just went into the moderation queue. Not sure why; I suspect because it has links in it. Stupid Wordpress. Sorry about that. :)
I think it'd be fine to provide "transitioning" help. It's not there so you can say "stop using LibX, start using JQuery": it's there so people who are already debating doing that can find out how. Your point about the philosophy of a library is very well taken; I'd like to see more of that. It takes some time working with a library to get a feel for the soul of the thing, which way it tends to lean, and a summary of that sort of thing from the devs before you start working with a library would be pretty hugely helpful.
Stuart,
this is great feedback! You bring up all very valid points (even the name ;)). Yes, the API docs are not there. I released it just yesterday, but plan on them being there this week.
This is not a replacement library for jQuery (meaning that you can't swap this out for jQuery, and your code magically begins working).
My best advice for playing with it now is to just read the unminified source... it's fairly simple to read. Anyhow, I'd like to link to this post because it has such great criticism. It will definitely give readers something to think about. Good and bad.
Best,
Dustin
FYI: there is some partial documentation now found here: http://dedchain.dustindiaz.com/api/docs/
We've actually considered providing library-specific documentation for jQuery. We opted not to (for now) due to the fact that it would provide a negative outward appearance for the library (your library sucks! use this one instead!). Although, maybe it isn't as bad as we think it would be.
I think the most important part of those tutorials would be the introduction of the library's specific philosophies, and how they differ from another library. This is an aspect that trips most people up, coming from another library (e.g. Prototype emphasizes ID selectors, jQuery emphasizes full selectors.) One isn't necessarily right, and the other wrong, but pointing out those differences is absolutely important.
We currently list the "transitioning" tutorials here:
http://docs.jquery.com/Main_Page/Desired
That list tends to complement the full list of desired tutorials listed here:
http://docs.jquery.com/Tutorials/Desired