News for hackers. Stuff that matters.
Re:How the Dat Protocol Works by tln on Friday July 05, 2019 @01:48PM (#20364331)
The diagrams on this page are FANTASTIC.

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/

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:

https://ssbc.github.io/scuttlebutt-protocol-guide/

Re:How the Dat Protocol Works by deaddodo on Friday July 05, 2019 @04:02PM (#20365391)
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.
Re:How the Dat Protocol Works by dmitriid on Saturday July 06, 2019 @01:19AM (#20368057)
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.
Re:How the Dat Protocol Works by jcims on Friday July 05, 2019 @07:30PM (#20366727)
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/

Re:How the Dat Protocol Works by aisidun on Friday July 05, 2019 @05:00PM (#20365865)
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.
Re:How the Dat Protocol Works by bborud on Saturday July 06, 2019 @06:57AM (#20369021)
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:)