[docs] Is the order of merge guaranteed?

While answering a question I actually came across the thought of whether the order of a merged observable is guaranteed if the input observables emit synchronously. Consider this example:

Observable.merge(Observable.of(1), Observable.of(2))
  .subscribe(console.log);

Is this guaranteed to emit 1 and then 2 or could it also be the other way around? I’m not so much asking about the current implementation but about the contract the merge operator gives me.

Whatever the answer, it should probably be documented. The current docs don’t seem to mention the order at all.

[staltz]

This seems like the behavior of the recursive scheduler. Can you read https://staltz.com/primer-on-rxjs-schedulers.html and see if that answers most of your concerns?

[benlesh]

Closing in favor of an issue on the docs repository: https://github.com/ReactiveX/rxjs-docs/issues/241