rmuir commented on issue #15225: URL: https://github.com/apache/lucene/issues/15225#issuecomment-3446658634
For javadocs in particular, I am concerned about how these chatbots generate text that is 400% more verbose than it needs to be. We need to be very careful around this, such javadocs will slow development velocity. Any time the code is refactored, the docs must be fixed to match, or various linters will start to fail. Code examples need to be kept extremely minimal in the rare cases where it does make sense: the maintenance cost is very high and we don't have great validation for these. -- 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]
