Rant HN: Microsoft Writes Useless Documentation

docs.microsoft.com

3 points_nhh4 comments

Is it just me or is the whole documentation from microsoft products so deeply flawed that it is not even near usable?

There is soo much noise I cannot believe this. Man how people ship aspnet core things IN TIME!?

There are Factories and Generics and thousands of boilerplate code everywhere in each of my tests but i cannot even access a dbcontext.

This is consultantware at its best.

I have no experience with Microsoft documentation. Still, I don't expect you can extrapolate from aspnet core docs to the whole Microsoft docs including kernel, userland and UI, compilers, programming languages, gaming products, etc.

What other products with unusable docs have you had experience with? Can you point to some particularly bad examples from aspnet core for my own education?

Also, I'm curious about how awful/passable/good documentation is distributed among the many tech products Microsoft owns and publishes docs on. Do you know about any good docs from them?

Today i read a very good article about modern c++ in the ms docs. I guess you are right and me is just too big to complain about. The aspnet docs are still leaving me puzzled

You're posting too fast. Please slow down. Thanks.

Reply on news.ycombinator.com