▲ 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 SmartmanApps@programming.dev to c/programmer_humor@programming.dev 175 comments fedilink hide all child comments
[–] Darohan@lemmy.zip 135 points 11 months ago (2 children) People say "RTFM" then you get to the manual and it's this permalink fedilink source hideshow 4 child comments replies: [–] SmartmanApps@programming.dev [S] 104 points 11 months ago (3 children) Microsoft Manuals... permalink fedilink source parent hideshow 6 child comments replies: [–] hoshikarakitaridia@lemmy.world 49 points 11 months ago (2 children) That is spot on. Usually you would expect the manual to be hit and miss when it comes to troubleshooting but Microsoft is consistently miss, skipping the important parts and details. permalink fedilink source parent hideshow 4 child comments replies: [–] 9bananas@feddit.org 22 points 11 months ago (4 children) Microsofts documentation is also increasingly just outright wrong: if you spend enough time looking up things about their newer products like M365, defender, or azure, especially when it comes to scripting related to those, there's a ton of simply outdated info on the official docs that makes it really difficult to figure out why your setup isn't doing what it's supposed to. from changed variable names, to missing functions, to unexplained buttons, etc., etc. the newer docs are straight up trash! you're better off searching around for forum posts or whatever, than using the official docs... permalink fedilink source parent hideshow 8 child comments replies: [–] nogooduser@lemmy.world 6 points 11 months ago (1 child) Microsofts documentation is also increasingly just outright _wrong_: There used to be a spot on joke about Microsoft documentation taking the piss out of the fact that it was always 100% accurate but at the same time pretty useless. That joke hasn’t been relevant for a while. It’s so frustrating trying to find out how to do something in one of the admin centres for M365 and you find a Microsoft document with exactly what you need in it only to find out that the UI has changed and the steps don’t work now. Did they move it? Did they remove it? Who knows? permalink fedilink source parent hideshow 2 child comments replies: [–] 9bananas@feddit.org 4 points 11 months ago our admins are regularly straight up fighting against this bs! "where the fuck has this fucked off to now?? it was right here last month?!" so glad I'm not doing MS administration... permalink fedilink source parent [–] eodur@piefed.social 5 points 11 months ago (1 child) If you are used to documentation like MS's, then AI responses probably look more reasonable and useful. If AI results look better than your own docs you should feel really bad. permalink fedilink source parent hideshow 2 child comments replies: [–] 9bananas@feddit.org 4 points 11 months ago this is the part that's really frustrating: i sometimes feel forced to use chatGPT (duck.ai) to simply search for Microsoft things, because search engines only return SEO garbage with the exact same content spammed across like a million "tech tips for beginners" sites...and the docs, as established, are pretty useless... keep in mind: i fucking hats "AI". making me use it makes me not have anything to do with whatever you're selling. it's getting progressively more impossible to simply use MS products, because the information you need to use them is so hidden away! combine those two things and ta-da: that's why all my stuff at home is running linux now. permalink fedilink source parent [–] felbane@lemmy.world 3 points 11 months ago Amazon is no better. Go look up the correct parameter format required to set a compliance lock on an object in S3 via the API. Now try it yourself. Surprise! permalink fedilink source parent [–] SmartmanApps@programming.dev [S] 2 points 11 months ago* (last edited 11 months ago) (1 child) you’re better off searching around for forum posts or whatever, than using the official docs Yep, that's why I started the Lemmy .NET MAUI Community - try and reassemble the collective experts who got scattered when Microsoft shutdown the old Xamarin forum - they had been invaluable when I was trying to learn Xamarin from the Microsoft resources. permalink fedilink source parent hideshow 2 child comments replies: [–] 9bananas@feddit.org 2 points 11 months ago oh hey, that's great! thank you! permalink fedilink source parent [–] 30p87@feddit.org 3 points 11 months ago Also, requiring login. permalink fedilink source parent [–] CookieOfFortune@lemmy.world 3 points 11 months ago Basically Hello World using the win32 API. I believe I first encountered this before college, and it took actually professional dev experience to really understand it. permalink fedilink source parent [–] SpikesOtherDog@ani.social 2 points 11 months ago Link 1: Pencil selection guide Link 2: Ovals vs. circles Link 3: Wings Link 4: Bird feet permalink fedilink source parent [–] RaivoKulli@sopuli.xyz 9 points 11 months ago (1 child) Another problem is that people skim to the "most important bits" without knowing they're skipping something important. Then some of those people complain how the manual is shit. I guess it could be shit if it is way too verbose though. permalink fedilink source parent hideshow 2 child comments replies: [–] inbeesee@lemmy.world 1 point 11 months ago Exactly what I was thinking. Like needing to understand a huge preamble just to do the Very Simple Thing. I just want to move on, not marry this Linux command. permalink fedilink source parent
[–] SmartmanApps@programming.dev [S] 104 points 11 months ago (3 children) Microsoft Manuals... permalink fedilink source parent hideshow 6 child comments replies: [–] hoshikarakitaridia@lemmy.world 49 points 11 months ago (2 children) That is spot on. Usually you would expect the manual to be hit and miss when it comes to troubleshooting but Microsoft is consistently miss, skipping the important parts and details. permalink fedilink source parent hideshow 4 child comments replies: [–] 9bananas@feddit.org 22 points 11 months ago (4 children) Microsofts documentation is also increasingly just outright wrong: if you spend enough time looking up things about their newer products like M365, defender, or azure, especially when it comes to scripting related to those, there's a ton of simply outdated info on the official docs that makes it really difficult to figure out why your setup isn't doing what it's supposed to. from changed variable names, to missing functions, to unexplained buttons, etc., etc. the newer docs are straight up trash! you're better off searching around for forum posts or whatever, than using the official docs... permalink fedilink source parent hideshow 8 child comments replies: [–] nogooduser@lemmy.world 6 points 11 months ago (1 child) Microsofts documentation is also increasingly just outright _wrong_: There used to be a spot on joke about Microsoft documentation taking the piss out of the fact that it was always 100% accurate but at the same time pretty useless. That joke hasn’t been relevant for a while. It’s so frustrating trying to find out how to do something in one of the admin centres for M365 and you find a Microsoft document with exactly what you need in it only to find out that the UI has changed and the steps don’t work now. Did they move it? Did they remove it? Who knows? permalink fedilink source parent hideshow 2 child comments replies: [–] 9bananas@feddit.org 4 points 11 months ago our admins are regularly straight up fighting against this bs! "where the fuck has this fucked off to now?? it was right here last month?!" so glad I'm not doing MS administration... permalink fedilink source parent [–] eodur@piefed.social 5 points 11 months ago (1 child) If you are used to documentation like MS's, then AI responses probably look more reasonable and useful. If AI results look better than your own docs you should feel really bad. permalink fedilink source parent hideshow 2 child comments replies: [–] 9bananas@feddit.org 4 points 11 months ago this is the part that's really frustrating: i sometimes feel forced to use chatGPT (duck.ai) to simply search for Microsoft things, because search engines only return SEO garbage with the exact same content spammed across like a million "tech tips for beginners" sites...and the docs, as established, are pretty useless... keep in mind: i fucking hats "AI". making me use it makes me not have anything to do with whatever you're selling. it's getting progressively more impossible to simply use MS products, because the information you need to use them is so hidden away! combine those two things and ta-da: that's why all my stuff at home is running linux now. permalink fedilink source parent [–] felbane@lemmy.world 3 points 11 months ago Amazon is no better. Go look up the correct parameter format required to set a compliance lock on an object in S3 via the API. Now try it yourself. Surprise! permalink fedilink source parent [–] SmartmanApps@programming.dev [S] 2 points 11 months ago* (last edited 11 months ago) (1 child) you’re better off searching around for forum posts or whatever, than using the official docs Yep, that's why I started the Lemmy .NET MAUI Community - try and reassemble the collective experts who got scattered when Microsoft shutdown the old Xamarin forum - they had been invaluable when I was trying to learn Xamarin from the Microsoft resources. permalink fedilink source parent hideshow 2 child comments replies: [–] 9bananas@feddit.org 2 points 11 months ago oh hey, that's great! thank you! permalink fedilink source parent [–] 30p87@feddit.org 3 points 11 months ago Also, requiring login. permalink fedilink source parent [–] CookieOfFortune@lemmy.world 3 points 11 months ago Basically Hello World using the win32 API. I believe I first encountered this before college, and it took actually professional dev experience to really understand it. permalink fedilink source parent [–] SpikesOtherDog@ani.social 2 points 11 months ago Link 1: Pencil selection guide Link 2: Ovals vs. circles Link 3: Wings Link 4: Bird feet permalink fedilink source parent
[–] hoshikarakitaridia@lemmy.world 49 points 11 months ago (2 children) That is spot on. Usually you would expect the manual to be hit and miss when it comes to troubleshooting but Microsoft is consistently miss, skipping the important parts and details. permalink fedilink source parent hideshow 4 child comments replies: [–] 9bananas@feddit.org 22 points 11 months ago (4 children) Microsofts documentation is also increasingly just outright wrong: if you spend enough time looking up things about their newer products like M365, defender, or azure, especially when it comes to scripting related to those, there's a ton of simply outdated info on the official docs that makes it really difficult to figure out why your setup isn't doing what it's supposed to. from changed variable names, to missing functions, to unexplained buttons, etc., etc. the newer docs are straight up trash! you're better off searching around for forum posts or whatever, than using the official docs... permalink fedilink source parent hideshow 8 child comments replies: [–] nogooduser@lemmy.world 6 points 11 months ago (1 child) Microsofts documentation is also increasingly just outright _wrong_: There used to be a spot on joke about Microsoft documentation taking the piss out of the fact that it was always 100% accurate but at the same time pretty useless. That joke hasn’t been relevant for a while. It’s so frustrating trying to find out how to do something in one of the admin centres for M365 and you find a Microsoft document with exactly what you need in it only to find out that the UI has changed and the steps don’t work now. Did they move it? Did they remove it? Who knows? permalink fedilink source parent hideshow 2 child comments replies: [–] 9bananas@feddit.org 4 points 11 months ago our admins are regularly straight up fighting against this bs! "where the fuck has this fucked off to now?? it was right here last month?!" so glad I'm not doing MS administration... permalink fedilink source parent [–] eodur@piefed.social 5 points 11 months ago (1 child) If you are used to documentation like MS's, then AI responses probably look more reasonable and useful. If AI results look better than your own docs you should feel really bad. permalink fedilink source parent hideshow 2 child comments replies: [–] 9bananas@feddit.org 4 points 11 months ago this is the part that's really frustrating: i sometimes feel forced to use chatGPT (duck.ai) to simply search for Microsoft things, because search engines only return SEO garbage with the exact same content spammed across like a million "tech tips for beginners" sites...and the docs, as established, are pretty useless... keep in mind: i fucking hats "AI". making me use it makes me not have anything to do with whatever you're selling. it's getting progressively more impossible to simply use MS products, because the information you need to use them is so hidden away! combine those two things and ta-da: that's why all my stuff at home is running linux now. permalink fedilink source parent [–] felbane@lemmy.world 3 points 11 months ago Amazon is no better. Go look up the correct parameter format required to set a compliance lock on an object in S3 via the API. Now try it yourself. Surprise! permalink fedilink source parent [–] SmartmanApps@programming.dev [S] 2 points 11 months ago* (last edited 11 months ago) (1 child) you’re better off searching around for forum posts or whatever, than using the official docs Yep, that's why I started the Lemmy .NET MAUI Community - try and reassemble the collective experts who got scattered when Microsoft shutdown the old Xamarin forum - they had been invaluable when I was trying to learn Xamarin from the Microsoft resources. permalink fedilink source parent hideshow 2 child comments replies: [–] 9bananas@feddit.org 2 points 11 months ago oh hey, that's great! thank you! permalink fedilink source parent [–] 30p87@feddit.org 3 points 11 months ago Also, requiring login. permalink fedilink source parent
[–] 9bananas@feddit.org 22 points 11 months ago (4 children) Microsofts documentation is also increasingly just outright wrong: if you spend enough time looking up things about their newer products like M365, defender, or azure, especially when it comes to scripting related to those, there's a ton of simply outdated info on the official docs that makes it really difficult to figure out why your setup isn't doing what it's supposed to. from changed variable names, to missing functions, to unexplained buttons, etc., etc. the newer docs are straight up trash! you're better off searching around for forum posts or whatever, than using the official docs... permalink fedilink source parent hideshow 8 child comments replies: [–] nogooduser@lemmy.world 6 points 11 months ago (1 child) Microsofts documentation is also increasingly just outright _wrong_: There used to be a spot on joke about Microsoft documentation taking the piss out of the fact that it was always 100% accurate but at the same time pretty useless. That joke hasn’t been relevant for a while. It’s so frustrating trying to find out how to do something in one of the admin centres for M365 and you find a Microsoft document with exactly what you need in it only to find out that the UI has changed and the steps don’t work now. Did they move it? Did they remove it? Who knows? permalink fedilink source parent hideshow 2 child comments replies: [–] 9bananas@feddit.org 4 points 11 months ago our admins are regularly straight up fighting against this bs! "where the fuck has this fucked off to now?? it was right here last month?!" so glad I'm not doing MS administration... permalink fedilink source parent [–] eodur@piefed.social 5 points 11 months ago (1 child) If you are used to documentation like MS's, then AI responses probably look more reasonable and useful. If AI results look better than your own docs you should feel really bad. permalink fedilink source parent hideshow 2 child comments replies: [–] 9bananas@feddit.org 4 points 11 months ago this is the part that's really frustrating: i sometimes feel forced to use chatGPT (duck.ai) to simply search for Microsoft things, because search engines only return SEO garbage with the exact same content spammed across like a million "tech tips for beginners" sites...and the docs, as established, are pretty useless... keep in mind: i fucking hats "AI". making me use it makes me not have anything to do with whatever you're selling. it's getting progressively more impossible to simply use MS products, because the information you need to use them is so hidden away! combine those two things and ta-da: that's why all my stuff at home is running linux now. permalink fedilink source parent [–] felbane@lemmy.world 3 points 11 months ago Amazon is no better. Go look up the correct parameter format required to set a compliance lock on an object in S3 via the API. Now try it yourself. Surprise! permalink fedilink source parent [–] SmartmanApps@programming.dev [S] 2 points 11 months ago* (last edited 11 months ago) (1 child) you’re better off searching around for forum posts or whatever, than using the official docs Yep, that's why I started the Lemmy .NET MAUI Community - try and reassemble the collective experts who got scattered when Microsoft shutdown the old Xamarin forum - they had been invaluable when I was trying to learn Xamarin from the Microsoft resources. permalink fedilink source parent hideshow 2 child comments replies: [–] 9bananas@feddit.org 2 points 11 months ago oh hey, that's great! thank you! permalink fedilink source parent
[–] nogooduser@lemmy.world 6 points 11 months ago (1 child) Microsofts documentation is also increasingly just outright _wrong_: There used to be a spot on joke about Microsoft documentation taking the piss out of the fact that it was always 100% accurate but at the same time pretty useless. That joke hasn’t been relevant for a while. It’s so frustrating trying to find out how to do something in one of the admin centres for M365 and you find a Microsoft document with exactly what you need in it only to find out that the UI has changed and the steps don’t work now. Did they move it? Did they remove it? Who knows? permalink fedilink source parent hideshow 2 child comments replies: [–] 9bananas@feddit.org 4 points 11 months ago our admins are regularly straight up fighting against this bs! "where the fuck has this fucked off to now?? it was right here last month?!" so glad I'm not doing MS administration... permalink fedilink source parent
[–] 9bananas@feddit.org 4 points 11 months ago our admins are regularly straight up fighting against this bs! "where the fuck has this fucked off to now?? it was right here last month?!" so glad I'm not doing MS administration... permalink fedilink source parent
[–] eodur@piefed.social 5 points 11 months ago (1 child) If you are used to documentation like MS's, then AI responses probably look more reasonable and useful. If AI results look better than your own docs you should feel really bad. permalink fedilink source parent hideshow 2 child comments replies: [–] 9bananas@feddit.org 4 points 11 months ago this is the part that's really frustrating: i sometimes feel forced to use chatGPT (duck.ai) to simply search for Microsoft things, because search engines only return SEO garbage with the exact same content spammed across like a million "tech tips for beginners" sites...and the docs, as established, are pretty useless... keep in mind: i fucking hats "AI". making me use it makes me not have anything to do with whatever you're selling. it's getting progressively more impossible to simply use MS products, because the information you need to use them is so hidden away! combine those two things and ta-da: that's why all my stuff at home is running linux now. permalink fedilink source parent
[–] 9bananas@feddit.org 4 points 11 months ago this is the part that's really frustrating: i sometimes feel forced to use chatGPT (duck.ai) to simply search for Microsoft things, because search engines only return SEO garbage with the exact same content spammed across like a million "tech tips for beginners" sites...and the docs, as established, are pretty useless... keep in mind: i fucking hats "AI". making me use it makes me not have anything to do with whatever you're selling. it's getting progressively more impossible to simply use MS products, because the information you need to use them is so hidden away! combine those two things and ta-da: that's why all my stuff at home is running linux now. permalink fedilink source parent
[–] felbane@lemmy.world 3 points 11 months ago Amazon is no better. Go look up the correct parameter format required to set a compliance lock on an object in S3 via the API. Now try it yourself. Surprise! permalink fedilink source parent
[–] SmartmanApps@programming.dev [S] 2 points 11 months ago* (last edited 11 months ago) (1 child) you’re better off searching around for forum posts or whatever, than using the official docs Yep, that's why I started the Lemmy .NET MAUI Community - try and reassemble the collective experts who got scattered when Microsoft shutdown the old Xamarin forum - they had been invaluable when I was trying to learn Xamarin from the Microsoft resources. permalink fedilink source parent hideshow 2 child comments replies: [–] 9bananas@feddit.org 2 points 11 months ago oh hey, that's great! thank you! permalink fedilink source parent
[–] 9bananas@feddit.org 2 points 11 months ago oh hey, that's great! thank you! permalink fedilink source parent
[–] CookieOfFortune@lemmy.world 3 points 11 months ago Basically Hello World using the win32 API. I believe I first encountered this before college, and it took actually professional dev experience to really understand it. permalink fedilink source parent
[–] SpikesOtherDog@ani.social 2 points 11 months ago Link 1: Pencil selection guide Link 2: Ovals vs. circles Link 3: Wings Link 4: Bird feet permalink fedilink source parent
[–] RaivoKulli@sopuli.xyz 9 points 11 months ago (1 child) Another problem is that people skim to the "most important bits" without knowing they're skipping something important. Then some of those people complain how the manual is shit. I guess it could be shit if it is way too verbose though. permalink fedilink source parent hideshow 2 child comments replies: [–] inbeesee@lemmy.world 1 point 11 months ago Exactly what I was thinking. Like needing to understand a huge preamble just to do the Very Simple Thing. I just want to move on, not marry this Linux command. permalink fedilink source parent
[–] inbeesee@lemmy.world 1 point 11 months ago Exactly what I was thinking. Like needing to understand a huge preamble just to do the Very Simple Thing. I just want to move on, not marry this Linux command. permalink fedilink source parent