You have to consider the opportunity cost, probably those people engineering time is better placed on M3 gpu drivers. It takes really excepcional and kind people to achieve what they did AND prepare public documentation along the way for the profit of open source community. It sometimes happens, and we have to celebrate that more, but it's not the normal.

Or, you know, they could hire good technical writers for a fraction of the cost and have them work together with developers, just like other companies do?

Devs would have to write just the hairiest parts.

yep that sounds reasonable, no idea why Apple doesn't do that, my wild guess is that there aren't enough technical writers that can understand low level code, or just a company/team culture that doesn't value it.

You speak so blithely, I can see you've never gone through an Apple documentation review...

Speak less blithely yourself, then ;-)