• If it’s all gobbledygook to you, then you weren’t the target audience.

    Beginners are the target audience for tutorials. Many tutorials are written in gobbledygook. See Microsoft documentation, which would’ve instead said GDG, and assumed you knew what GDG was.

    Most developers are writing for developers who have approximately the same skill level and knowledge

    If they had the same skill level and knowledge then they wouldn’t need a tutorial to begin with.

    The vast majority of tutorials out there are definitely not aimed at beginners

    And that’s precisely the problem with the vast majority of tutorials.

    Now, if it were 95% easy to follow, and then there was one step that was only a few words long and made no sense at all, that would be the typical badly written tutorial

    Microsoft: Now all you have to do is add in a GDG

    I must have skimmed through 30 tutorials aimed at people roughly my skill level before I finally found one that explained the missing bit

    Now imagine reading Mircosoft documentation and not being able to find anything which explains what GDG is. Classic “rest of Owl”.

    they’re actually really hard to write

    No they’re not. You include what the pre-requisite knowlege is, along with links to resources about the pre-requisite knowledge. See Creating MAUI UI’s in C#

    • merc@sh.itjust.works
      link
      fedilink
      arrow-up
      1
      ·
      2 months ago

      Beginner’s are the target audience for tutorials.

      No, most of the time they’re not. And you don’t need to warn me that an “s” is coming.

      If they had the same skill level and knowledge then they wouldn’t need a tutorial to begin with.

      Note that I said “approximately”, not the identical level of skill and knowledge. It’s written by a fooblorts developer who uses migwed and ghai and is now looking to connect suwdo with ugfest. If you’re also a fooblorts developer who wants to connect suwdo with ugfest but you have no experience with that particular thing, then the tutorial is for you. It’s not for someone who has never used any of those technologies and doesn’t understand anything about them.

      No they’re not

      Ah, I can see you never write tutorials, nevermind then. You have no idea what you’re talking about.