mpbarano commented on issue #15225: URL: https://github.com/apache/lucene/issues/15225#issuecomment-3444224540
> I don't see the purpose of generating docs with LLM. User can always do this themselves. > > Docs should contain information that can't be automatically generated from the source code. > > To me this only creates technical debt, sorry. Using LLM alone at least currently doesn't generate fully accurate documentation. Using LLMs to generate documentation requires careful reading and vetting of the docs. In my recent experience I have found LLMs routinely generate errors (I am using Cursor default which I believe is Claude). I have been reading everything 3-4 time, testing what I can, and fixing mistakes. Some example mistakes: - LLM misordered and misnumerated parameters for some methods in its code examples. - I was looking at docs for HighFreqTerms command line and it documented that you could view terms by numeric fields isn't sensible input and fails. - There were errors in how it documented the command line. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
