2 ms·
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
by userbinator 2y ago
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.
- rqtwteye 2y agoApple’s docs also have gone downhill since the 90s. Does anybody still make good documentation?
- haradion 2y agoI've found MDN and the Rust programming language docs to be pretty solid.
- playingalong 2y agoI enjoy and appreciate Slack API reference. https://api.slack.com/ https://api.slack.com/