HN2new | past | comments | ask | show | jobs | submitlogin



I'd originally told them "just follow the docs" because normally Microsoft's documentation is top notch, but this time I was dead wrong.

MS' docs have been on a steady decline ever since they moved away from MSDN and went to an "open source" "community project" with them. For some of the newer stuff, a page without any spelling or grammar errors or unnaturally odd phrasing is exceedingly rare, and I have heard that they are attempting to use AI to write and edit them. I've seen older pages from MSDN era get destroyed and turned into a mess due to their edits presumably to optimise for SEO (and thus not humans.) It will only get worse. They of course beg people to contribute fixes, as that article alludes to, but there's no point in doing that when you know your contributions are just going to get mangled into AI-generated muck.


Apple’s docs also have gone downhill since the 90s. Does anybody still make good documentation?


I've found MDN and the Rust programming language docs to be pretty solid.


I enjoy and appreciate Slack API reference.

https://api.slack.com/




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: