documentation of the "Effects" would benefit from 'continuation style' examples

documentation of the "Effects" would benefit from 'continuation style' examples

(disclaimer: although I don't consider myself a dumb-ass, I may be completely off here, I studied the effects mechanism only briefly - don't be scared to correct me)

Although the "Effects" documentation is quite extensive, the 'callback' arguments are barely mentioned.

Since continuation style programming is becoming more popular (I'm not even coming from the web development world), I think it would be a good idea to mention on the general "Effects" documentation how effects are handled by a queue, and thus asynchronously: no need to worry about 'endless recursion'.
  1. function keepgoing() {
  2.     $("#id")
  3.        .fadeIn(100)
  4.        .delay(1000)
  5.        .fadeOut(100
  6.                    , keepgoing 
  7.                    );
  8. }
Also worth mentioning: through this queueing mechanism, above function will not take 1200 milliseconds to return.


Regards,

Kristoffel