Comment by ChrisMarshallNY
10 hours ago
Ahem...
My code usually clocs at 50/50 (or thereabouts)[0]. Has, since my very first real engineering project (in 1987)[1]. I discuss in detail, here[2].
But one reason that I like LLMs, is that they help me to write even more documentation. I have found that I can instruct an LLM to revise my documentation, and make it even more effective.
[0] https://github.com/ChrisMarshallNY (My GH profile. Pretty much everything there, is like that -has, since long before LLMs were a broken rubber on the drug store shelf).
[1] https://littlegreenviper.com/wp-content/uploads/2022/07/TF30... (Downloads a PDF)
Your code isn't as unnecessarily commented as this. E.g. look at this line
https://github.com/RiftValleySoftware/RVS_Spinner/blob/d44ee...
An LLM would have commented `// Create temporary UI view.`
Completely redundant comments like this are a classic hallmark of LLMs:
Dunno why I have been downvoted for stating the obvious.
Also from my brief look at one file it looks like you have 50% comments because you have a gazillion comment separator lines.
I didn't downvote. There's nothing wrong with your comment. It's just a bit silly, because humans definitely write that much. I learned from Apple and Adobe headerdocs.
I worked for a Japanese company that accreted comments.
Yeah, lots of whitespace.