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
[–] [S] 2 points 1 year ago (4 children)

a responsibility to somehow make complicated topics easy

That's what tutorials are for! 😂

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 4 child comments
    •
  • [–] 1 point 1 year ago (3 children)

    Some topics are just complicated. If I write you a tutorial in fast Fourier transforms I can’t start the tutorial at 1+1=2.

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 3 child comments
    •
  • [–] [S] 1 point 1 year ago (2 children)

    I can’t start the tutorial at 1+1=2

    But you can put it in the pre-requisites

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 2 child comments
    •
  • [–] 1 point 1 year ago (1 child)

    Of course. But that wasn’t the complaint/satire of the satirist whose article we’re discussing.

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 1 child comment
    •
  • [–] [S] 1 point 1 year ago

    Of course. But that wasn’t the complaint/satire of the satirist whose article we’re discussing

    I think you'll find that's a huge part of the complaint - unexplained terminology. See Microsoft tutorials that never tell you what any of their TLA's are, nor link to any explanations of them, exactly as is satirised

  • permalink
  • fedilink
  • source
  • parent