Thank you, that was very informative. I think the way forward is to pursue something like cargo but as a swift compiler command like swift doc or swift build -doc perhaps. Maybe this is too outlandish, but building docs by default (with a disable flag of course) would definitely incentivize writing documentation.
At this point, I feel we are kinda waiting on Apple to do something about the official docs. Apple seems content on only working on new features and new things, but never wants to pay attention to the nitty gritty documentation. I feel that we could use some people working on solely official documentation, at least until it is complete. I'd be happy to do some work myself, but I don't know the ins and outs and it'll take very long.