It covers near everything, is extremely exhaustive, and constantly updated. That being said, if you're more interested in how the Windows API is organized/works internally (why you have to give it handles/resources and what those mean, for instance), then Charles Petzold's series is generally considered the definitive resource:
I really miss the MSDN CD-ROMs. They had all of the information without network latency. Indexed and searchable. Categorized in a tree, complete with code examples you could immediately try. Press F1 on a function and there is the reference.
Most of the old APIs still work exactly the same so I am frequently tempted to look stuff up in my VS6 install just because it's so fast and convenient.
MSDN_Library_October_2001 is the latest one they mailed out for Visual Studio 6.
I remember reading a funny story somewhere recently that back in the day, ms developers intentionally left gaps in the docs or straight up didn't document certain apis etc so they could put them in their books and sell those so if you were working on certain things you'd be forced to buy said books.
Haha, that's totally believable and in tune with the MicrosoftMentality of those days. I'd love to see the corroborating evidence, though! If I recall correctly, the (also paid) MSDN developer reference documentation was actually pretty OK. The problems you needed Petzold and Richter for were the higher level "why is Windows this way?" topics and "what's the Windows-way to design XYZ?" questions. The actual APIs themselves had good documentation--the problem was knowing you had to use a particular API for a particular problem, which is what we needed the books for.
There's the rather famous AARD Code (https://en.wikipedia.org/wiki/AARD_code), though that is from an era a little before Win32. And, well, it's not a documentation issue for app developers, as much a way to trick OS developers.
LOL @ those memos. This was long before all our companies adopted the "Don't say anything in E-mail that could become evidence" training. Their ruthlessness and obsession with destroying everything not-Microsoft was truly unique and special. I can't think of any company here in modern times so focused on not only winning but making sure absolutely everyone else lost. Old-school Microsoft was wild.
I know there are many legends like this, but I wouldn't be too sure about that.
For example, most of the authors of the old-time classics were not employed by Microsoft when they wrote their books. I think Charles Petzold (Windows Programming) was a freelancer, Jeffrey Richter (MFC) was working a company called Wintellect, David Solomon (Inside Windows NT) had a seminar company (Solsem), I think initially primarily for VMS and Mark Russinovich (Inside Windows 2000) at Winternals Softwre.
I've been digging for the article since morning, iirc it was something around directx, will update this comment when and if I can find it. It's not this link but it also touches on some of the stuff on this node https://retrocomputing.stackexchange.com/questions/25955/did...
I'm convinced this is true for SharePoint development. There were things that I'd find in books that weren't even mentioned anywhere on any microsoft website, let alone documented properly.
I remember a different reason - APIs were intentionally not documented so Microsoft Products were the only apps that would know how to use them (and gain an advantage over the competition)
When I joined MS my boss told me that Microsoft apps weren't allowed to use internal APIs, I think as part of the anti-trust settlement. Windows components (e.g. the Settings app) can, but actual apps (e.g. Word) couldn't do anything third-party developers wouldn't be allowed to do. Some APIs are considered public but their documentation is less than useful, admittedly. But with those I don't have access to anything better either. :/
(Disclaimer: I speak for myself, based on my memory of public knowledge.)
Wow this is the first time I've seen someone recommend a microsoft.com domain name for 'updated' information.
Usually its 1 year and 15 upgrades outdated.
Its basically why I have completely given up on Microsoft. Every update is a breaking change that isnt updated in their docs. And chances are, it wasnt going to work anyway.
Any time you have to use a microsoft service/product, know that documentation is just going to be worse than any FOSS made by teens.
You will also often see big chinking warnings that the site is no longer updated pointing you to homepage of current docs site, despite the APIs you're looking for being still current.
Is the new documentation lacking something you need? Is there some reason you don't use the outdated documentation, if it's working for you? Are you mad because there are redundant resources available to you?
I'm literally writing this to you on a Laptop exclusively running Fedora Linux. I do most of my development in OSS tools. I'm not some fanboy, yet despite that (or maybe due to that) I'm still able to recognize the very obvious fact that Microsoft has very robust documentation.
Perception is important in discoverability of documentation, and yes, vibes are also part of it.
The complaint is that now it often ends up disjointed, especially when you're starting to search for a topic, and the links pointing you to "new site because this one no longer updated" don't point to the same topic (or area) on the new site.
Also, I have absolutely no idea where you come from with fanboyism or Microsoft hate as context in previous comment.
https://learn.microsoft.com/en-us/windows/apps/
https://learn.microsoft.com/en-us/windows/apps/get-started/s...
https://learn.microsoft.com/en-us/windows/win32/api/
It covers near everything, is extremely exhaustive, and constantly updated. That being said, if you're more interested in how the Windows API is organized/works internally (why you have to give it handles/resources and what those mean, for instance), then Charles Petzold's series is generally considered the definitive resource:
https://www.amazon.com/gp/product/B00JDMP71S/