Jonathan Blow on LLVM documentation

Jonathan Blow draws the connection between five-year-olds and the LLVM team.

Captured from a j_blow twitch stream (now expired) in Dec 2022.

[ernesto]

LLVM docs are a testament to the human mind simply giving up

[PaulPaulPaulson]

"Do we want to provide some useful documentation?" "No, let's just auto generate some nonsense which is less useful than looking at the original code it was generated from."

[wisnoskij]

Thank you for filling this Blow drought.

[rhone]

I gave up trying to use LLVM a while ago. I get that it's supposed to be a general purpose compiler framework. However, I couldn't find any decent, current documentation to explain how to implement my language. I started looking at the code, threw up, and started work on my own compiler.

[SimGunther]

Technology gave us the ability to filter out spaghetti to only see the connections we want to see

Instead, we get literal spaghetti 😂

[filiformis]

"I could have worked on food for people who are hungry"
What are you talking about? You have a beautiful plate of spaghetti right in front of you.

[andrewdunbar]

The spaghetti code was never solved. It was moved here.

[SethPentolope]

lol
It’s time for the 5 year old to draw spaghetti, now let’s make it the first thing you see when trying to get stuff done

[bloody_albatross]

Never understood that include graph in Doxygen. Even if it would be drawn in a sensible way, what is is good for?? Maybe a list of the include files would be useful and clicking on them you see what files they include etc. But that graph? What?

[anon-fzbo]

lol his initial reactions were priceless. i laughed too just looking at that... chart?

[samysamy]

u gotta play connect the dots to understand what even is going on.

[oberguga]

It is probably automatically generated diagram with a really bad settings and definitely without proper supervision.

[krux]

As the father of a five year old, my daughter draws much prettier. Lots of people that look like from World of Goo.

[SnakeEngine]

Just let ChatGPT sort the messy drawing.

[lphane]

I think this was Doxygen + Graphviz. Having used it myself I know these charts. With some adapted settings they may become nicer, indeed.

[Ratstail]

My greatest achievement as a game developer is being blocked by Jon Blow.

[helldunkel]

Laughing so hard at some auto generated dependency graphs make him look a bit dubious i find. Those messed up graphs are everywere and its often not trivial to come up with a better solution.

[sporefergieboy]

libclang is actually great though despite the documentation being totally fucked. Can’t speak about llvm though

[MisterFanwank]

And Chandler Carruth is proud of this nonsense.

[pleggli]

I mean you can click on the other .h nodes to refine if you really want to follow one of the paths.. It's not that bad.