2
Anti-Patterns in Software Blogging (refactoringenglish.com)
submitted 1 month ago by [B] to c/lobsters@lemmy.bestiver.se
comment fedilink hide all child comments
 

Comments

no comments (yet)

sorted by: hot top controversial new old
there doesn't seem to be anything here
4 comments in c/programming@programming.dev view that post
[–] 5 points 1 month ago (1 child)

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.

  • permalink
  • fedilink
  • source
  • hideshow 1 child comment
    •
  • [–] 3 points 1 month ago

    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.

  • permalink
  • fedilink
  • source
  • parent
    • [–] 2 points 1 month ago

    Recipe blogs also suffer similar anti-patterns.

    For all the trappings of AI, I count cooked.wiki a blessing there.

  • permalink
  • fedilink
  • source
    •
    [–] 1 point 1 month ago

    "sequel"

  • permalink
  • fedilink
  • source
    •