[znfi]

Having been forced to dabble in the Microsoft world I have in general found documentation to, at least in some cases, be very sparse. Or maybe I've just not found the right resources?

For example, I was looking for some documentation on how to tune the CLR, and performance tips for writing C# in general. In Java there are lots of books on the topic, and I know of some blogs on the JVM internals, but for .Net all I could find was one small (selfpublished?) book. I'm not sure it would be fair for me to judge the state of the blogs and online resources, but at least I did not find what I was looking for at the time.

Similarly, I had to try some stuff with Service Fabric, and it felt more or less impossible to get it working with the publicly available documentation. I'm really not sure how they think one is supposed to learn how to use that technology.

Lastly I've been dealing with shipping and releasing natively compiled binaries for Windows etc, and here I've found online resources, but mostly unofficial ones. This whole area seems rather hairy and it feels a bit scary to rely on some random blogpost or stackoverflow answers for what (not) to do.

In general from what I've seen is that the Microsoft documentation is very much How-To focused. But there is often a lack for more comprehensive documentation like a man page, and in particular I've found it hard to get "sharp" information, like what are the exact guarantees for this thing.