this post was submitted on 11 Apr 2024
321 points (97.9% liked)

Technology

59605 readers
3438 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 content.
  3. Be excellent to each another!
  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, to ask if your bot can be added please contact us.
  9. Check for duplicates before posting, duplicates may be removed

Approved Bots


founded 1 year ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
[–] gerryflap@feddit.nl 65 points 7 months ago (3 children)

When I was a student I never understood how something like this could happen. "Just rewrite it" I thought, how hard can that be. But working in a corporate environment I now totally understand it. Everything you write will at some point become part of code that, to the fast majority of colleagues, will just be a black box that they've never touched and don't intend to. Despite my urge to test and document everything, I've already more than once complained about my own code, only realizing later that I wrote it myself. Often you can still find out what it does, but the "why" gets lost and because of that people are afraid to change it.

[–] 5too@lemmy.world 6 points 7 months ago (1 children)

Often you can still find out what it does, but the “why” gets lost and because of that people are afraid to change it.

I feel like this is what gets lost whenever documentation is talked about. Yes, you should probably be able to work out what something does by looking carefully at it - but why can be so easily lost!

[–] vivavideri@lemmy.world 2 points 7 months ago

Well I suppose that reminds me, I ought to comment the why and the where a bit more lol

load more comments (1 replies)