In reply to Captain Black.

I agree that shifting the onus to core team is an important step toward decreasing documentation debt as you put it. In the 11 months I've been the docs committer for WordPress core, this has been one of the primary goals.

That said, moving to a parsed code reference, in my opinion, is a giant step toward strengthening the parity between what's been changed and what's been documented -- when it comes to functional docs. If there's an expectation that missing documentation is a bug and not something we can just "catch up on later", that mentality-shift alone will be worth the years of effort put in up to this point.