waku-org / research

Waku Protocol Research
MIT License
3 stars 0 forks source link

Fix plots for paper #91

Closed alrevuelta closed 4 months ago

alrevuelta commented 4 months ago

Fix plots for paper

s-tikhomirov commented 4 months ago

A few suggestions from my part.

Mesh figure

On the yellow envelope and arrows as edges:

From the general principle of simplifying things:

More generally, I worry that the "local mesh" term might confuse people. Yes, it's a term from the original GossipSub paper, but I'm not sure it's widely used elsewhere in this meaning. IMO, we can say: "mesh topology" (a network where all nodes have a similar degree); "mesh connection" (a type of GossipSub connection that behaves a certain way, an opposite of "gossip connection"), and maybe "the mesh" (all mesh connections - although I'd prefer "the mesh network" maybe). Instead of "P1 mesh" I would say "P1's mesh neighbors" or even "P1's neighbors" if it's clear from the context that we're talking about the mesh network. In the context of the figure in question, I'm not sure what's the value add of depicting the "P1 mesh" and "P8 mesh".

Indices: I suggest we change the notation for latencies using this principle: the lower index shows what happens (g - generation, v - validation, t - transmission), and the upper index shows where it happens (for generation and validation it is an index of a node, for transmission it's "A -> B" (or "A-B", or "A,B" - we can discuss), where A and B are the indices of the nodes, or abbreviations of cities).

A note on the generation latency: for uniformity, shall we add there an upper index for the publisher node (L_g^1).

Message hops figure

My suggestions would be:

Distribution figure

The main issue I see here is that there is a lot of things going on, and the reader might get lost. In particular, there are a lot of "variable = value" captions, which I think are better represented in other forms (such as a table).

My suggestions:

Sidenote: we shouldn't refer in the text to colors on the diagram because a) some people will print the paper in black-and-white, b) some people are color-blind. Ideally, all lines on the chart should be distinguishable only by solid / dashed lines, etc with color as an additional distinguishing factor.

s-tikhomirov commented 4 months ago

Update: I modified some figures: