HNGlance

Top Best New Show

Ask HN: Developers, what do you miss in dev docs?

https://news.ycombinator.com/item?id=31053244

by mlejva • 4 years ago

3 3 4 years ago

NE

news.ycombinator.com

Related Stories

Loading related stories...

Comments

3

controlledchaos2• 4 years ago

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

mlejva• 4 years ago

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?

controlledchaos2• 4 years ago

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.

Source preview

news.ycombinator.com

HNGlance

© 2024-2026 HN Glance. Story content belongs to its original sources.

Privacy
Terms