Should yield* be the recommendation in co's documentation?

[jeswin]

Since yield* can give better stack traces and error reporting, should that be the recommendation in co's documentation? When using just yield, all you get is the final generator function with no reference to who invoked it.

[jonathanong]

sure, but you need REALLY GOOD DOCS otherwise you're going to confuse more people than you help. i consider yield* a more advanced topic

[jeswin]

I agree. Also, switching to yield* doesn't solve the problem by itself. If the final method is a thunkified version of a node-style API (which is pretty much always), you will need to catch that exception in the inner-most generator and re-throw after adding generator-specific call stack information. I have no idea how that could be explained. :/

Having said that, until making the change above my debugging was limited to placing console.log calls everywhere and hoping for the best.