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 to c/programmer_humor@programming.dev
175 comments fedilink hide all child comments
you are viewing a single comment's thread
view the rest of the comments
[–] 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
    •
  • [–] 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
    •
  • [–] 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
    •
  • [–] 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
  • [–] 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
    •
  • [–] 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
  • [–] [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
    •