“Hello! I am a developer. Here is my relevant experience: I code in Hoobijag and sometimes jabbernocks and of course ABCDE++++ (but never ABCDE+/^+ are you kidding? ha!)  and I like working with Shoobababoo and occasionally kleptomitrons. I’ve gotten to work for Company1 doing Shoobaboo-ing code things and that’s what led me to the Snarfus. So, let’s dive in! 
  • 💡𝚂𝗆𝖺𝗋𝗍𝗆𝖺𝗇 𝙰𝗉𝗉𝗌📱@programming.devOPEnglish
    4·
    27 days ago

    It would be pretty insane to in a tutorial for something at a higher level of expertise, include all the foundational knowledge to get to that level of expertise

    You don’t need to include it all. You just need to mention it as pre-requisite knowledge, and link to resources about it for those who don’t have that knowledge. See Creating MAUI UI’s in C#

    I get the impression that most people who go to the trouble of writting about how to do something prefere to do explanations rather than recipes

    Good documentation includes both. i.e. step-by-step guide, with explanations. See above.

    so either seek recipes with an even lower base level

    All documentation should cater to all levels. See above.

    • Aceticon@lemmy.dbzer0.comEnglish
      51·
      27 days ago

      For “all documentation” to “cater to all levels” it would have to explain to people “how do you use a keyboard” and everything from there upwards, because there are people at that level hence it’s part of “all levels”.

      I mean the your own example of good documentation starts with an intro of “goals” saying:

      “Visual Studio (VS) does not (currently) provide a blank .NET Multi-platform Application User Interface (MAUI) template which is in C# only. In this post we shall cover how to modify your new MAUI solution to get rid of the XAML, as well as cover how to do in C# code the things which are currently done in XAML (such as binding). We shall also briefly touch on some of the advantages of doing this.”

      For 99% of people almost all that is about as understandable as Greek (expect for Greek people, for whom it’s about as understandable as Chinese).

      I mean, how many people out there in the whole World (non-IT people as illustrated in the actual article linked by the OP) do you think know what the hell is “Visual Studio”, “.Net”, “Multi-platform Application User Interface”, “template”, “C#”, “XAML”, “binding” (in this context).

      I mean, if IT knowledge was a scale of 1 to 10 with 10 the greatest, you’re basically thinking it’s “catering to all levels” when an explanation for something that is level 8 knowledge (advanced programming) has a baseline required level of 7 (programming). I mean, throw this at somebody that “knows how to use Excel” which is maybe level 4 and they’ll be totally lost, much less somebody who only knows how to check their e-mail using a browser without even properly understanding the concept of "browser (like my father) which is maybe level 2 (he can actually use a mouse and keyboard, otherwise I would’ve said level 1).

      I think you’re so way beyond the average person in your expertise in this domain that you don’t even begin to suspect just how little of our domain the average person knows compared to an mere programmer.

      • 💡𝚂𝗆𝖺𝗋𝗍𝗆𝖺𝗇 𝙰𝗉𝗉𝗌📱@programming.devOPEnglish
        14·
        27 days ago

        it would have to explain to people “how do you use a keyboard”

        No it wouldn’t. You just link to resources about pre-requisite knowledge.

        and everything from there upwards

        Nope. Exact same thing applies to all pre-requisite knowledge.

        For 99% of people almost all that is about as understandable as Greek

        Now scroll down to the pre-requisite knowledge which has links to things explaining ALL of that.

        how many people out there in the whole World (non-IT people as illustrated in the actual article linked by the OP) do you think know what the hell is “Visual Studio”, “.Net”, “Multi-platform Application User Interface”, “template”, “C#”, “XAML”, “binding” (in this context)

        Exact same number as there is people capable of clicking on the provided links about them.

        which is maybe level 4 and they’ll be totally lost,

        …until they read the links in the pre-requisite knowledge, and then they will understand all of it.

        I think you’re so way beyond the average person in your expertise in this domain

        says person who didn’t even scroll past the introductory paragraph! 😂 You think people try to learn things by reading only the introductory paragraph?? 😂

        you don’t even begin to suspect just how little of our domain the average person knows compared to an mere programmer

        And yet, weirdly, if you keep reading you’ll find it caters to people who know nothing about it 😂