3 ms·
> other wasteful things (doc writing) I wish people would create more and better docs. Pour as much time into a meticulously written doc details as they discus
by teiferer 1mo ago
> other wasteful things (doc writing)
I wish people would create more and better docs. Pour as much time into a meticulously written doc details as they discuss indentation and variable naming style.
But instead, just like with your attitude, it's considered second grade or even useless work, and as a result docs always suck if they even exist. They don't get that code is made for people to consume just as much as for the machine, and docs are just an extension of that. That's one reason LLMs are so popular, they actually tell you what you'd have found in the doc, had it existed. But LLMs are restricted to the what and don't cover the why. I some places that makes good docs even rarer. In others it makes them easier since the machine generates the "fluff" and the human just fills in the rationale.