Skip to content
This repository has been archived by the owner on Oct 26, 2021. It is now read-only.

What are the semantics of colors, numerical values and shapes? #36

Open
mstevens83 opened this issue Aug 26, 2016 · 2 comments
Open

What are the semantics of colors, numerical values and shapes? #36

mstevens83 opened this issue Aug 26, 2016 · 2 comments

Comments

@mstevens83
Copy link

mstevens83 commented Aug 26, 2016

I'm relatively new (OK, very new) to the world of Rx. The marble diagrams are certainly helpful but I often get confused by them. What tends to throw me off is that it is unclear to me with the semantics are of the differences in colour and numerical value of the marbles (and also of the different shapes used in rx diagrams elsewhere). See for example http://rxmarbles.com/#distinct or http://reactivex.io/RxJava/javadoc/rx/Observable.html#distinct(rx.functions.Func1).
I can't seem to find a simple explanation of what these attributes mean in terms of the events/items/objects being represented by the marbles.

My best guess is that the colour is an indication of an object's type/class and the number an indication of an object's state, but it might as well be the other way around (or entirely different). And where does that leave the shapes?

@mlamothe
Copy link

I'm just a user, but my understanding is that this project only uses one shape: circles.

As for colors, I believe they're essentially random just to make it easier on the eyes that having one uniform color.

The only real states shown on these diagrams is the completed state (shown by a short vertical bar) and the "result" observable line at the bottom of each diagram.

@ghost
Copy link

ghost commented Oct 21, 2018

yes that would need documentation

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants