570
How I, a non-developer, read the tutorial you, a developer, wrote for me, a beginner - annie's blog (anniemueller.com)
submitted 3 weeks ago by SmartmanApps@programming.dev to c/programmer_humor@programming.dev
152 comments fedilink hide all child comments
you are viewing a single comment's thread
view the rest of the comments
[-] Flamekebab@piefed.social 12 points 3 weeks ago

On the flipside I've encountered docs that expect the reader to already understand the functionality in order to be able to use the docs. They seem to exist solely as a reminder to those who already know.

There's a reason I don't bother running my own mailservers anymore!

[-] SmartmanApps@programming.dev 4 points 3 weeks ago

They seem to exist solely as a reminder to those who already know

Perfect description of the entire Microsoft .NET documentation, signed, .NET beginner who not only didn't have a .NET background, but not even a Microsoft programming background (which is also heavily assumed throughout - way to make newbies feel completely unwelcome in your ecosystem!).

[-] fmstrat@lemmy.nowsci.com 3 points 3 weeks ago

Oh man, this I do hate. If you have terminology in your app, that is not a standard, please, please define it.

this post was submitted on 25 Sep 2025
570 points (100.0% liked)

Programmer Humor

26898 readers
487 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
Feyter@programming.dev
anzo@programming.dev
BurningTurtle@programming.dev
pylapp@programming.dev