-4
Ship types, not docs (shiptypes.com)
submitted 9 months ago by codeinabox@programming.dev to c/programming@programming.dev
10 comments fedilink hide all child comments

cross-posted from: https://lemmy.bestiver.se/post/919071

Comments

you are viewing a single comment's thread
view the rest of the comments
[-] tavernusmaximus@piefed.social 3 points 9 months ago

Every time you update the code, someone has to remember to update the description. They won’t.

I get there are some exceptions where devs don't have access to the docs, but I read this more like "Every time I update the code, I have to remember to update the description. I won't." Which, fair, but that's the author's problem. Writing docs is part of the job, table stakes stuff.

this post was submitted on 11 Feb 2026
-4 points (33.3% liked)

Programming

29238 readers
366 users here now

Welcome to the main community in programming.dev! Feel free to post anything relating to programming here!

Cross posting is strongly encouraged in the instance. If you feel your post or another person's post makes sense in another community cross post into it.

Hope you enjoy the instance!

Rules

Rules

  • Follow the programming.dev instance rules
  • Keep content related to programming in some way
  • If you're posting long videos try to add in some form of tldr for those who don't want to watch videos

Wormhole

Follow the wormhole through a path of communities !webdev@programming.dev

founded 3 years ago
MODERATORS
snowe@programming.dev
Ategon@programming.dev
UlrikHD@programming.dev
bugsmith@programming.dev
Spyro@programming.dev