Although improving recently, Microsoft still struggles with "our docs contain lots of knowledge but not a lot of wisdom." I go to documentation to find wisdom a

Although improving recently, Microsoft still struggles with "our docs contain lots of knowledge but not a lot of wisdom." I go to documentation to find wisdom about the whys and why nots, not just the hows (i.e., method signatures and syntax).