ppkarwasz commented on PR #1417:
URL: https://github.com/apache/commons-lang/pull/1417#issuecomment-3094526782

   @garydgregory,
   
   Since I use AI too for many **non-critical** tasks (e.g. generate some 
documentation without wasting my time), I am not so adamant against 
AI-generated content. As long as a human controls the process, AI is just a 
tool!
   
   @Naveenkumarsuk,
   
   That said, Gary is partially right: if you are using AI as a tool, please 
correct its output. What we expect is:
   
   - Having the **same** documentation on both the methods: in the end one of 
them is a specialization of the other with `"null"` as second parameter.
   - Correct indentation.
   - Correct `@since` documentation: this is **very** useful when somebody 
looks at the published Javadoc, but does not find the method in its own 
application.
   - Nullability documentation of the `@param` tags: this is part of the 
contract of the method and **can not** be removed. 


-- 
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]

Reply via email to