[controlledchaos]

Do you mean, “What things do you miss when writing documentation as a developer?”

[mlejva]

Originally, I meant it like what do you wish dev docs would do better to make it easier to understand how to use APIs, SDKs, devtools, etc.

I'm also interested in the other angle that you described. What do you miss when writing docs?

[controlledchaos]

My opinion is that dev docs should always start with common use cases that drill into related SDKs/APIs. I find that they are oddly separated more often than I’d like them to be. Microsoft seems to be getting the picture with their .NET 6 documentation.