528
this post was submitted on 10 Apr 2025
528 points (96.5% liked)
Technology
68772 readers
5366 users here now
This is a most excellent place for technology news and articles.
Our Rules
- Follow the lemmy.world rules.
- Only tech related news or articles.
- Be excellent to each other!
- Mod approved content bots can post up to 10 articles per day.
- Threads asking for personal tech support may be deleted.
- Politics threads may be removed.
- No memes allowed as posts, OK to post as comments.
- Only approved bots from the list below, this includes using AI responses and summaries. To ask if your bot can be added please contact a mod.
- Check for duplicates before posting, duplicates may be removed
- Accounts 7 days and younger will have their posts automatically removed.
Approved Bots
founded 2 years ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
Good code documentation describes why something is done, and no just what or how.
To answer why you have to understand the context, and often, you have to be there when the code was written and went through the various iterations.
LLMs might be able to explain what is done, with some margin of error, but why something is done, I would be very surprised.
Well, we don't have that. We're mostly dealing with other people's mistakes and tech debt. We have messy things like nested stored procedures.
If all we get is some high level documentation of how components interact I'm happy. From there we can start splitting off the useful chunks for human review.