this post was submitted on 25 Sep 2025
537 points (95.6% liked)

Programmer Humor

27215 readers
1349 users here now

Welcome to Programmer Humor!

This is a place where you can post jokes, memes, humor, etc. related to programming!

For sharing awful code theres also Programming Horror.

Rules

founded 2 years ago
MODERATORS
anzo@programming.dev
Feyter@programming.dev
BurningTurtle@programming.dev
pylapp@programming.dev
537
How I, a non-developer, read the tutorial you, a developer, wrote for me, a beginner - annie's blog (anniemueller.com)
submitted 1 month ago by SmartmanApps@programming.dev to c/programmer_humor@programming.dev
153 comments fedilink hide all child comments
you are viewing a single comment's thread
view the rest of the comments
[โ€“] Ilovethebomb@sh.itjust.works 80 points 1 month ago (10 children)

At least once in their life, every tech person should be forced to teach someone like my mum how to use a piece of technology.

That will very quickly change your perspective on what counts as user friendly.

[โ€“] felbane@lemmy.world 5 points 1 month ago

I think the issue is that you need to understand who your users actually are. Documentation for a library intended to be used by a reasonably competent software engineer is going to have different requirements vs documentation for a cli utility aimed at Arch btw Linux users vs documentation for a program to help Grandma organize family photos.

If you throw a terminal command at Grandma she's going to panic and call her grandchild. If you put instructions for extracting a tarball in your library docs the programmer is going to get bored and skip ahead.

load more comments (9 replies)