←back to thread

923 points zh2408 | 2 comments | | HN request time: 0.408s | source
Show context
remoquete ◴[] No.43748908[source]
This is nice and fun for getting some fast indications on an unknown codebase, but, as others said here and elsewhere, it doesn't replace human-made documentation.

https://passo.uno/whats-wrong-ai-generated-docs/

replies(1): >>43750928 #
1. kaycebasques ◴[] No.43750928[source]
My bet is that the combination of humans and language models is stronger than humans alone or models alone. In other words there's a virtuous cycle developing where the codebases that embrace machine documentation tools end up getting higher quality docs in the long run. For example, last week I tried out a codebase summary tool. It had some inaccuracies and I knew exactly where it was pulling the incorrect data from. I fixed that data, re-ran the summarization tool, and was satisfied to see a more accurate summary. But yes, it's probably key to keep human technical writers (like myself!) in the loop.
replies(1): >>43751174 #
2. remoquete ◴[] No.43751174[source]
Indeed. Augmentation is the way forward.