Add figures to the documentation

[mlegner]

Some concepts would be easier to understand with visual support:

• How all ecosystem components fit together and interact
• How blobs, slivers, shards, and storage nodes are related

Suggested in #106

[nerodk89]

Working on this one.

[nerodk89]

Hi @mlegner, I would like to provide a quick update on the progress and confirm my understanding of the Walrus architecture. Please correct me if I'm wrong. I just want to ensure that I'm on the right track and and can continue working with Aggregators, Caches, and Publishers. Thanks

[mlegner]

Hi @nerophung! Thanks for your work! ❤️

This is roughly correct. However, the total number of shards is exactly the same as the number of slivers for a blob and each shard contains exactly one sliver for each blob. So you would not have a situation like shard 1 in your picture that has two slivers for the same blob.

[mlegner]

Also, one question: Would you be able and willing to provide the source files for this and other images for whatever tool you use? We may have to modify them later and that is difficult with just the final image files.

[nerodk89]

Also, one question: Would you be able and willing to provide the source files for this and other images for whatever tool you use? We may have to modify them later and that is difficult with just the final image files.

Yes, I just sent you the image for a quick update. I'll send all the source files afterward.

[nerodk89]

Hi @nerophung! Thanks for your work! ❤️

This is roughly correct. However, the total number of shards is exactly the same as the number of slivers for a blob and each shard contains exactly one sliver for each blob. So you would not have a situation like shard 1 in your picture that has two slivers for the same blob.

Thanks for clearing up my confusion. I will make the adjustment.

[nerodk89]

Correct if i'm wrong. Thanks

[mlegner]

Thanks a lot, @nerophung, looks very good. 💯

A few minor things:

• The number of storage nodes and the number of shards are generally different. (In the picture, you have #N for storage nodes and again for the shards in the first storage node.)
• The number of slivers for a particular blob is equal to the total number of shards. (In the picture it looks as if there were only 3 slivers.)
• The shards assigned to a particular storage node are not necessarily contiguous. So, it doesn't need to be 1, 2, ..., n; it could also be 1, 7, 13, ...

[nerodk89]

Thank for the explaination! Hope that this version work 🙏