kotlinx.coroutines icon indicating copy to clipboard operation
kotlinx.coroutines copied to clipboard

Marble diagrams

Open r4zzz4k opened this issue 4 years ago • 6 comments

ReactiveX site has a nice visualizations for describing operators called marble diagrams. They often help with understanding of the operator, e.g. for checking specifics of operator behavior, like this one:

concatMap marble diagram

One can also find that RxJS has numerous examples of interactive diagrams. On the other hand, some use plaintext versions which arguably can be also representative enough.

It would be nice to have some kind of marble diagrams for Flow operators.

r4zzz4k avatar Feb 19 '20 15:02 r4zzz4k

I plan to make a copy of rxmarbles but for Flow. Will make a basic version by the end of this week.

rougsig avatar Mar 11 '20 00:03 rougsig

https://flowmarbles.com/

rougsig avatar Mar 14 '20 20:03 rougsig

I think, official docs should be updated with marble diagrams for all examples.

xuanswe avatar Mar 20 '22 16:03 xuanswe

Unfortunately, we have neither resources nor plans to support marble diagrams on our own, and adding third-party references to kotlinlang is not the best way to go for us, though we probably should mention it in the readme

qwwdfsad avatar Mar 21 '22 08:03 qwwdfsad

May be i can create PR to put flowmarbles inside of your docs? Sources will be inside kotlin repo.

rougsig avatar Mar 21 '22 08:03 rougsig

Great proposal! Unfortunately we are just don't have any capacity for additional activities right now and it is hard to tell whether we are ready to review and/or accept it. I do hope we'll be able to come back to it in two months or so

qwwdfsad avatar Mar 22 '22 14:03 qwwdfsad