this post was submitted on 09 Aug 2026
271 points (93.6% liked)

Technology

87649 readers
3262 users here now

This is a most excellent place for technology news and articles.


Our Rules


  1. Follow the lemmy.world rules.
  2. Only tech related news or articles.
  3. Be excellent to each other!
  4. Mod approved content bots can post up to 10 articles per day.
  5. Threads asking for personal tech support may be deleted.
  6. Politics threads may be removed.
  7. No memes allowed as posts, OK to post as comments.
  8. 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.
  9. Check for duplicates before posting, duplicates may be removed
  10. Accounts 7 days and younger will have their posts automatically removed.

Approved Bots


founded 3 years ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
[–] Treczoks@lemmy.world 0 points 2 weeks ago (9 children)

For me, that is all integrated part of "programming". You missed the documenting the code part, but i consider this as an oversight.

[–] Aceticon@lemmy.dbzer0.com 9 points 2 weeks ago* (last edited 2 weeks ago) (8 children)

It says a lot that you think a coding good practice like "documenting things in code" which is at the level of using descriptive variable and function names, should be in the same bucket as structural non-coding processes (which are often entire professionions or very senior professional branches) like Requirements Analysis or Technical Architecture, both highly-complex things (the latter being the very top in seniority of the technical career track) which are non-existent in a formal sense in improvisational (read: amateur as fuck) "programming" companies.

You're making my point on the whole Dunning-Krugger thing.

[–] Treczoks@lemmy.world 4 points 2 weeks ago* (last edited 2 weeks ago) (2 children)

Not only in code. Documentation for the end user (or at least halfway there, the final document is done by a separate department), is important, too.

There is a reason that my job description is "Embedded Systems Architect". But I see this complete packet as "programming".

[–] MangoCats@feddit.it 2 points 2 weeks ago

Interesting thing I see is that LLM slop generators are actually quite efficient at generating documentation, both for the end users and for developers, and like human generated slop-docs, the more cycles you put into review and refinement of them (both human guided and LLM self-review/refinement) the better quality you get out. Investing even half the person-hours in LLM generated documentation generates higher quality, more complete, better organized and more readable documentation for me than "working with a team" of writers who all have to meet and re-meet and explain and re-explain ad-nauseum until we're all sick of the process and late for delivery of the documentation products.

When this documentation investment is made in the code, some remarkable things come out like: a project co-developed with Claude in Python took 10 interactive days to make. At the end, the Python was performing fine but a little on the noticeably slow side, so the LLM was told "do it again in Go" and 3 days later with very minimal prompting, the whole thing was re-implemented in Go, running 10x faster, and flawlessly performing the same functions which were developed in Python in 10 days - I believe precisely because a significant part of the Python project was: documentation of requirements, design specifications and automated tests.

load more comments (1 replies)
load more comments (6 replies)
load more comments (6 replies)