this post was submitted on 25 Jul 2023
596 points (99.0% liked)
Programming
17489 readers
35 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 1 year ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
Oh god, oh no.
Do you realize what that will mean? My coworkers will have to learn how to understand documentation standards that rely on anything but "self documenting code."
I am already "an expert (lol @ my salary)" because I read shit they don't bother looking up. We're truly doomed.
That's a pipe dream thinking all the documentation is complete and well detailed
I can't count the times where I read the documentation for the tutorial to get started and the steps described in the official documentation by the official maintainer fails early.
Documentation is 99% an afterthought (slight exaggeration here)