Inconsistency kills me. I’ve a colleague at work who insists on putting every doc through an llm to make it look nice then dumps it on the wiki. Now the wiki is a clusterfuck of assumptions and inconsistent styling.
Our documentation on some tedious process does not need to look like a magazine article nor does it help me find the salient code snippets that will help me understand why this awkward bit of code is the way it is.
Yeah, honestly if I notice something has AI in it, I don’t use it anymore. Open source projects with a CLAUDE.md or whatever in them? No, thanks.
The amount of assumptions they make are really one big issue what makes them suck so bad. In the end you just have more work. Instead of getting done 80% of the work in 20% of the time, now you get 30% of the work done in 1% of the time, but good luck getting the remaining stuff done at all.
Inconsistency kills me. I’ve a colleague at work who insists on putting every doc through an llm to make it look nice then dumps it on the wiki. Now the wiki is a clusterfuck of assumptions and inconsistent styling.
Our documentation on some tedious process does not need to look like a magazine article nor does it help me find the salient code snippets that will help me understand why this awkward bit of code is the way it is.
Meanwhile he thinks he’s achieved something.
Yeah, honestly if I notice something has AI in it, I don’t use it anymore. Open source projects with a CLAUDE.md or whatever in them? No, thanks.
The amount of assumptions they make are really one big issue what makes them suck so bad. In the end you just have more work. Instead of getting done 80% of the work in 20% of the time, now you get 30% of the work done in 1% of the time, but good luck getting the remaining stuff done at all.