560
How I, a non-developer, read the tutorial you, a developer, wrote for me, a beginner - annie's blog (anniemueller.com)
submitted 11 months ago by to c/programmer_humor@programming.dev
175 comments fedilink hide all child comments
you are viewing a single comment's thread
view the rest of the comments
[–] 15 points 11 months ago (1 child)

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
    •
  • [–] 14 points 11 months 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 2 child comments
    •
  • [–] 2 points 11 months 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