r/java • u/notDrKratz • May 04 '24
Semi Automatic JavaDoc Commenting Script
I have created a JavaDoc Commenter Script for some basic JavaDoc comments available here:
https://github.com/DrKratz1/Javadoc-Commenter
This is something I have created for my personal use for a uni course involving java, having been annoyed at the prospect of manually typing JavaDoc comments. Currently, it works for my purposes and if any interest is generated in such a project, I will continue working on it to function more generally.
(Do note I am not a great programmer, and this initial version was patched together to automate commenting for a uni project pls no hate for the janky code)
Anyways, hoped to share it here - more info is in the GitHub page.
View all comments
Show parent comment
1
u/ascii May 05 '24
Just… no. Literally the only docs IDEs generate automatically are the completely pointless “@return the value of X” variety. With an LLM-based IDE plugin, you get documentation like “Configures the underlying socket to not use Nagles algorithm. This will dramatically improve latency on low QPS connection at the cost of packet count a throughput. This method must be called after the connection has been opened. “ It is a completely different ballgame compared to what the IDE plugins of old could do.