myskov commented on PR #3889: URL: https://github.com/apache/ozone/pull/3889#issuecomment-1298310320
@sodonnel Javadoc comments are used by IDEs to give hints, like in this example: <img width="792" alt="image" src="https://user-images.githubusercontent.com/2060295/199210643-9822becb-fdcd-4fd8-924f-1fc8fb6ffafe.png";> In the screenshot above, the hint is just the Apache license. This is caused by placing Apache license as javadoc comment. Apache Ozone is a complex product, and messy javadoc comments are not helping to deal with it. -- 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]
![https://user-images.githubusercontent.com/2060295/199210643-9822becb-fdcd-4fd8-924f-1fc8fb6ffafe.png"](https://user-images.githubusercontent.com/2060295/199210643-9822becb-fdcd-4fd8-924f-1fc8fb6ffafe.png"){kind=link}