Comment on How to properly document code?
CookieOfFortune@lemmy.world 11 months agoTo my knowledge that just formats existing comments. With LLMs you could probably do 95% of the actual commenting.
Comment on How to properly document code?
CookieOfFortune@lemmy.world 11 months agoTo my knowledge that just formats existing comments. With LLMs you could probably do 95% of the actual commenting.
superb@lemmy.blahaj.zone 11 months ago
Useful comments should provide context or information not already available in the code. There is no LLM that can generate good comments from the source alone
silas@programming.dev 11 months ago
Codium does surprisingly well at generating JSDoc, and it processes your code within the context of your entire codebase. Still not quite there yet but you might be surprised
CookieOfFortune@lemmy.world 11 months ago
Why wouldn’t it be able to? It can link similar code structure to data in its training set. Maybe the ones that aren’t at that level but it’s hardly a stretch to make these inferences. Most of the code you write is hardly novel.
superb@lemmy.blahaj.zone 11 months ago
If it’s not exactly novel, how many comments do you really need?
An LLM is just gonna describe the code it sees. Good comments should include information and context that is not already in the source.
CookieOfFortune@lemmy.world 11 months ago
I’m mostly talking about when you need to use JSDoc format which are usually for interfaces, so it’s usually just a chore for humans.
Probably harder to get good comments inside code, but it might still be possible.