3 ms·
Ask HN: Developers, what do you miss in dev docs?
- controlledchaos 4y agoDo you mean, “What things do you miss when writing documentation as a developer?”
- mlejva 4y agoOriginally, 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 4y agoMy 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.