Victor Vu

> It's not clear that the Consumption section is meant to be that exhaustive list, given that only some methods mention they cause a thunk (implying that the rest don't)....

@code-guru, if you're still interested, can you update this PR to change the `docs/templates/base.html` file? You can also remove the part that mentions `resume`. Then we can merge this.

That looks cool. +1.

If you want to convert each array into a single object, use `map`. If you want to convert each array into *multiple* objects, use `flatMap`. ```javascript highland(myArray) .map(page => highland(download(page))...

> Is there any advantage to using flatMap over sequence when it's just an array of objects? Sequence will work just as well for arrays. > Do I need to...

`parallel` will hold back errors the same way that it holds back stream values due to its ordering guarantee. `mergeWithLimit` will emit the error as soon as it gets it....

> Is it fine to have errors and stopOnError in the same stream? Yes. > Or as you said, done will throw if it handles an unhandled error, so maybe...

> So do the following 2 snippets have identical behavior, or is there still some difference in how they would work? They have identical behavior. > I've been playing around...

Sure, we can do that. PR welcome. :) However, I would be careful about treating highland streams as Node Stream++, as they don't implement the full `stream.Writable` interface. For example,...

I agree that this behavior is needlessly confusing, and if I had to do it again, I would have asked for fail-fast errors. I also agree on consistent type checking...