529
How I, a non-developer, read the tutorial you, a developer, wrote for me, a beginner - annie's blog (anniemueller.com)
submitted 1 year ago by 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
[–] 13 points 1 year ago (2 children)

Yeah, documentation isn't as good as it could be, and it would increase the accessibility of software if it was better.

  • permalink
  • fedilink
  • source
  • hideshow 2 child comments
    •
  • [–] 12 points 1 year ago* (1 child)

    The amount of time and skill it takes to write excellent and accessible documentation is just not reasonable for most developers, unless you have dedicated technical writers or it's a personal project without true deadlines.

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 1 child comment
    •
  • [–] 2 points 1 year ago

    So what? It may arguably be not a developer's fault, but it is everyone's problem, given the growing dystopian alternatives to an accessible distributed software ecosystem. A problem can be acknowledged without admitting blame. Happy cake day btw.

  • permalink
  • fedilink
  • source
  • parent