Rant HN: Microsoft Writes Useless Documentation
docs.microsoft.com
Rant HN: Microsoft Writes Useless Documentation
1–5 of 5 posts
Re: Rant HN: Microsoft Writes Useless Documentation
#2Is 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.
Re: Rant HN: Microsoft Writes Useless Documentation
#3Is 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?
Re: Rant HN: Microsoft Writes Useless Documentation
#4You're posting too fast. Please slow down. Thanks.
Re: Rant HN: Microsoft Writes Useless Documentation
#5Is 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 aw…
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