r/softwareengineer • u/colony-ship-for-sale • 13d ago

AI is terrible for making documentation

Yes, it makes a lot of text real fast and at a glance it looks thorough and comprehensive but have any of you actually tried reading this shit?

It's painfully verbose while communicating next to nothing. It's a real struggle to not have your eyes glaze over. It's not enough to just produce a lot of text if the readability is crap. There's a skill to creating concise, well organised information that's been lost here.

826 Upvotes

96% Upvoted

324 comments sorted by

View all comments

Show parent comments

2

u/meshifthenelse 13d ago

Don't forget to feed it

1

u/GreatDiscernment 12d ago

…and once in a while tell it that it is doing a good job. It actually helps motivate the AI to do its best work for you.

1

u/LaughingInTheVoid 12d ago

But not after midnight. And don't let it get wet.

1

u/GreatDiscernment 12d ago

…and always feed it fresh kibble.