Contrast the work I'm doing this week with Microsoft's Graph API.
The C# library Microsoft provides for this is on GitHub, and their library docs it turns out are auto-generated ... But they aren't automatically tested! So it's possible for the docs to simply not work, and since they're auto-generated they're automatically kept not working. So GitHub issues about non-working docs get closed because even the maintainers can't make small doc fixes. Brilliant /s
I wanted to call this "Continuous Disintegration" but somebody already coined that phrase.
Your experience reminds me of this one phone platform with poor third party app support but a pretty vibrant indie developer community. They'd make unofficial clients for all sorts of things, only to eventually get lawyered out of existence. It was both sad and hilarious:
"Hi, to protect the blah blah blah of our service you must take down your unofficial application"
"Okay, but is there an official client coming for the platform?"
The C# library Microsoft provides for this is on GitHub, and their library docs it turns out are auto-generated ... But they aren't automatically tested! So it's possible for the docs to simply not work, and since they're auto-generated they're automatically kept not working. So GitHub issues about non-working docs get closed because even the maintainers can't make small doc fixes. Brilliant /s
I wanted to call this "Continuous Disintegration" but somebody already coined that phrase.