It's bad. Apple's documentation is notoriously weak, despite them being one of the most well-resourced companies in the world.
Don't worry they're writing documentation now for AI agents
Honestly, this is by far the most amusing side effect of AI thus far -- management demanding better documentation to help AI digest it.