Minimize assumptions about the reader’s background knowledge.
EVERYONE who writes for an online publication needs tobhave this drilled into them. I feel like a good third of the articles and such that I read suffer from this problem, and yeah, it’s ESPECIALLY prevalent in software and tech.
At some point you have to assume some kind of knowledge though. If you have to explain everything from the basics, the moment a concept is slightly complicated, the blog gets thousands of pages long.
You don’t need to explain how an integer is represented in binary in memory in a blog post about atomic integers. Most people that read about atomic integers already know how integers are represented in memory.
Recipe blogs also suffer similar anti-patterns.
For all the trappings of AI, I count cooked.wiki a blessing there.
“sequel”
