dotnet / reactive

The Reactive Extensions for .NET
http://reactivex.io
MIT License
6.73k stars 751 forks source link

Align IntroToRx Start description with reality #2163

Closed idg10 closed 3 months ago

idg10 commented 3 months ago

Fixes #2162

The IntroToRx book incorrectly describes Observable.Start as offering "lazy" evaluation. In fact, it invariably schedules the work for immediate execution (or as near to immediate as your chosen scheduler can manage). The distinguishing feature of Start is that it doesn't matter if it takes a long time for this work to complete. (So unlike Return, where you need to have the value in hand before you can get it wrapped in an IObservable<T>, Start returns an IObservable<T> immediately. The callback can take as long as it likes, and the value will become available to observers once the callback completes.)

This change updates the relevant text to describe Starts behaviour correctly.