Add which are the other stardard methods of create

[BraisGabin]

I was using Observable.create(OnSubscribe). I knew about the warning:

This method requires advanced knowledge about building operators and data sources; please consider other standard methods first

But I didn't know which were the other stadard methods. There were no clue in the JavaDoc. With this change the problem is gone.

[akarnokd]

such as

[akarnokd]

But I didn't know which were the other stadard methods

I accept this change but developers should really spend time discovering the methods of RxJava for themselves. Otherwise we'd have 30k lines in Observable.java just to link and explain correlated methods.

[codecov-io]

Current coverage is 84.20% (diff: 100%)

Merging #5000 into 1.x will decrease coverage by 0.07%

@@                1.x      #5000   diff @@
==========================================
  Files           288        288          
  Lines         17806      17806          
  Methods           0          0          
  Messages          0          0          
  Branches       2698       2698          
==========================================
- Hits          15007      14994    -13   
- Misses         1950       1956     +6   
- Partials        849        856     +7   

Powered by Codecov. Last update 3716747...88b8730

[BraisGabin]

Updated.

I understand your concerns about the lenght of this file. But there's too much noise on internet about this method: posts, tutorials, gists...

[DavidMGross]

The reactivex.io docs group operators by category, including a "Creating Observables" <http://reactivex.io/documentation/operators.html#categorized> category. This may help you if you're trying to find just the right operator to initiate an Observable.

…

On Tue, Jan 17, 2017 at 4:36 AM, David Karnok ***@***.***> wrote: Merged #5000 <#5000>. — You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub <#5000 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AESHoOjpc8-Vdip48vBXpIHPVtopFtMpks5rTLW_gaJpZM4Lldk1> .

-- David M. Gross PLP Consulting

[BraisGabin]

I know... and this is all the information that I can find there:

RxJava implements this operator as create.

It is good practice to check the observer’s isUnsubscribed state from within the function you pass to create so that your Observable can stop emitting items or doing expensive calculations when there is no longer an interested observer.

Nothing about fromEmitter, the other overloads of create or the advance usage of create(OnSubscribe)... An update there would be great too. But I don't how to contribute there.