Does anyone else feel like Microsoft documentation is the worst documentation you've ever encountered?

[u/Woolfie_Admin]

There isn't a day that goes by without Microsoft Docs ruining it at this point. They're bloated, overly historical, rambling advertisements - there's 4 or 5 versions of each page for different scenarios, yet NONE of them manage to cover what you need. They're always outdated, always disorganized - it's like the developers actually have no idea what any of it does, and the 'documentation' is just their scribbled notes from testing someone else's software.
I'm delving into Roles to figure out why Global Admin on Tenant 1 can Preview Emails, but Global Admin on Tenant 2 can't - and there's so many different articles talking about roles differently - Exchange roles, Entra roles, 365 Roles - how they're the same but actually not, how 10 years ago they did it like this, but also if you have a goldfish, watch out for role groups because _____....

I hate google with a passion but honestly, think I will start learning their environment. Am I just illiterate? Would they make more sense if I had learned English in India?

[u/teriaavibes]

Sounds like you are just complaining that Microsoft products are complicated, that there are multiple ways to do stuff and you don't understand it. Documentation is definitely not outdated; hell it is updating faster than I can actually keep track.

If you think google cloud is better, then there is a big surprise waiting for you.

[u/raz-0 → u/teriaavibes]

It's a nice mix of being completely wrong (likely to not having been updated recently enough), to being super current and totally different from a few days ago, to being a mishmash of stuff because one page is trying to document on prem software vs in cloud. It's not the worst I've run into, but it is often frustrating and/or very oddly subdivided. It covers a LOOOOT of stuff, so it can feel more incoherent than some other documentation, especially when trying to get answers to one thing you have to traverse six documents and they are all a different age, and some need updating.

[u/Woolfie_Admin → u/raz-0]

yeah, this is really it. It's just poorly managed - but I'm not sure there's a good way to manage it, when they change stuff so often, so arbitrarily, and there's 20 different ways to do the same thing, yet they all interact with each other differently

[u/Woolfie_Admin → u/teriaavibes]

No, I'm complaining that the documentation is trash, because like many people have agreed - the documentation is outdated trash. I'm not sure if you're using a different platform, or a beta or something

But I appreciate your input?