1212

The general feeling of documentating things (lemmy.world)

submitted 3 months ago by merari42@lemmy.world to c/programmer_humor@programming.dev

54 comments fedilink hide all child comments

you are viewing a single comment's thread
view the rest of the comments

[-] IrateAnteater@sh.itjust.works 102 points 3 months ago

Every application kind of needs two modes: a default mode where the user is railroaded into making the right decision, and an "I'm not an idiot and will actually read the documentation before/after trying to make things work" mode. If you stick the toggle for the two modes somewhere that you'd only find by reading the documentation, people will automatically categorize themselves into the mode the ought to be in.

[-] entwine413@lemm.ee 80 points 3 months ago

You actually need proper documentation, though. I've had to read source code to discover or figure out how to use cli flags way too many damn times. (I'm not a real programmer, I just work on infrastructure).