@gruber The spirit of your latest column is right, but you’re wrong about who is to blame for the lack of developer adherence to Apple’s latest technologies and UI patterns:

Apple is (mostly) to blame, not developers.

1/3

Apple’s best and clearest documentation is delivered via yearly WWDC updates.

If a developer wants to build an app utilizing all of Apple’s accessibility features, for example, they would need to laboriously sift through 5-7 years of yearly accessibility updates from WWDC.

2/3

The Human-Interface Guidelines are the closest thing to a playbook for how to “make our app better for users,” but it’s woefully incomplete compared to slowly following WWDC updates for a decade.

Apple’s omission of such a collated, clear, and current playbook is the issue.

3/3

I got riled up and made a quick mockup of what I think Apple should provide.

Here is their existing documentation for maps in SwiftUI, and my mockup of what I wish they did instead: non-timely documentation with the clarity and production value of the yearly WWDC updates.

4/3