Re:How the Dat Protocol Works
by guessmyname on Friday July 05, 2019 @05:14PM
(#20365944)
Props to Duncan Keall for creating the diagrams [1][2].
> Duncan is a technical writer and illustrator interested in internet infrastructure, peer-to-peer protocols and net art.
[1] https://blog.datproject.org/2019/01/21/how-dat-works/
[2] https://github.com/datprotocol/how-dat-works/commits?author=...
Re:How the Dat Protocol Works
by ChristianBundy on Saturday July 06, 2019 @11:30AM
(#20370132)
He's great! He also did the Scuttlebutt protocol guide:
I agree. This is one of the best, modern protocol documentations I've seen. I've been tempted to redo old, but critical RFCs (FTP, HTTP, PNG, TCP, IP, etc) in a similar manner.
Re:How the Dat Protocol Works
by giancarlostoro on Friday July 05, 2019 @09:48PM
(#20367221)
I would pay good money for well thoughtout docs on all those protocols including HTTP, DNS, how they relate to mdns / avahi / bonjour and other modern implementations and differ as well as the IRC protocol. I would love to read RFCs front to back but I learn by talking with someone about tech or just seeing schematics / diagrams and pics and then lastly sheer experience.
For HTTP I highly recommend https://github.com/for-GET/http-decision-diagram/blob/master...
Scroll to Overview and then there are links to each section in the diagram
Re:How the Dat Protocol Works
by marvindanig on Saturday July 06, 2019 @01:26AM
(#20368085)
Great on desktop, unreadable on mobile though.
Re:How the Dat Protocol Works
by kaycebasques on Friday July 05, 2019 @05:32PM
(#20366052)
What is it about the diagrams that you find to be high-quality? I’m a technical writer and just curious about what stands out to readers.
Low noise, small palette, straight lines, good use of space.
Basically textbook Tufte philosophy with a good eye for proportion/symmetry/rhythm.
The scuttlebutt doc linked elsewhere in here is even more impressive IMHO. Kuodos to the designer.
Re:How the Dat Protocol Works
by social_quotient on Friday July 05, 2019 @04:17PM
(#20365504)
Any specific tooling generating these or just a good designer?
Re:How the Dat Protocol Works
by nanomonkey on Friday July 05, 2019 @05:20PM
(#20365973)
Duncan Keall is just talented. He also did the Scuttlebutt Protocol guide (https://ssbc.github.io/scuttlebutt-protocol-guide/).
Here is a blog post describing how it was made: https://blog.datproject.org/2019/01/21/how-dat-works/
Looking at the site repo, they are SVGs generated by Inkscape, so likely drawn by hand by a good designer.
Re:How the Dat Protocol Works
by euroclydon on Friday July 05, 2019 @04:58PM
(#20365853)
They could be done easily with Excel.
I was going to comment on the same thing. I’m squinting at my mobile phone screen so I bookmarked the site so I can check it later on a proper screen indoors. It just looked so good I thought I’d heck back later to learn something about lovely documentation:)
The dat homepage[1] is also nicely done. It would be interesting to see how much and how it's being used. Since there is a central tracker does anyone know if there are stats available?
[1]: https://dat.foundation/