this post was submitted on 25 Sep 2025
558 points (95.9% liked)

Programmer Humor

26673 readers
1786 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
558
How I, a non-developer, read the tutorial you, a developer, wrote for me, a beginner - annie's blog (anniemueller.com)
submitted 1 week ago by SmartmanApps@programming.dev to c/programmer_humor@programming.dev
177 comments fedilink hide all child comments
you are viewing a single comment's thread
view the rest of the comments
[–] BCsven@lemmy.ca 3 points 6 days ago

That said, it has to be structured so that it's really clear that those "explanation bits" are optional reading for the curious which have the knowhow to understand them

Yep, totally. This past year I spent a lot of time setting up an LMS with content.
I included sections that were tips, good to know, for awareness, etc.

Maybe only 1 out of every 20 users might expand the section, but if they do then there is a clear explanation of why this particular thing functions this way and how to make it work in alternate usecases. Images and explanation, before and after, etc.