“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
    2·
    14 days ago

    “just add this to the config folder” - which folder? Where?

    This is one of the biggest problems with Microsoft documentation (and maybe other ecosystems too). Doesn’t include any “using” statements in the snippet, leading to copying the code not working, because you don’t know what DLL this is using. They talk about 2 lines, and show you 2 lines, but the 2 lines don’t work without 1 or 2 other lines which they have left out. Happens every single time

    not correctly steering the user towards the relevant documentation about configuration values

    Microsoft documentation never links to anything else at all. If you don’t know how to do this thing they’re talking about, well now you have to go find a Youtube by some Indian programmer about it

    there’s a bit of a disconnect because a lot of tutorials exist that base level of knowledge that a complete beginner doesn’t have

    Yep. The man pages are so not user-friendly. I have always said that Unix is very powerful, but not the least bit user-friendly. Welcome to low adoption.