I recently got moved to another team after my company restructured. Several repos have zero documentation. Most of those don’t even have comments on the functions. LinkXxxx(some args) like Xxxx to /what?!/ It’s also an over-engineered mess with multiple layers of abstraction. I can’t wait to finish figuring out what everything does and re-write (and document it) like a sane person. This code presumably had no AI involvement which I’d argue is even worse since real humans made these shit decisions. Don’t get me starting on their testing (and mostly lack thereof)…
Worker suggested using AI to write some documentation. Another coworker did. I immediately spotted a bunch of hallucinated shit. Good times. I want to know in my head what a thing does, how it works, and how it fits into the architecture. I can’t do that if an AI is just deciding stuff; it’s like a quiz back in school where I would memorize shit for about one week before 99% of it left my brain forever.














… as someone in his 40s, this post makes me irrationally angry. Write. Don’t know what to write? Write something, anything, anyway until it starts to go somewhere. Read more, both authors you like/admire and maybe something you don’t to see what else is around.