Document new interop with reactive streams

[satabin]

The documentation still mentions only the deprecated reactive streams interop features. Now interop with Java Flow can be done directly on the Stream class and companion object. This should be reflected in the documentation.