A co-worker recently linked me to https://www.whatsnewinswift.com/. That's great, but it would be even better if SEs themselves took steps to make the changes their adoption leads to directly learnable.
This is an idea that's been taken up in a few communities already:
- EmberJS: https://github.com/emberjs/rfcs/blob/master/0000-template.md#how-we-teach-this
- Rust: https://github.com/rust-lang/rfcs/blob/master/text/1636-document_all_features.md#new-rfc-section-how-do-we-teach-this
Ember's has a remarkable concern for the impact on the "notional machine" that its users have.
Rust has gone a step further to require documentation land along with stabilization, in the form of guide, reference, and examples.
Is this something you see as lacking in Swift? Would introducing a "How do we teach this?" to the SE proposal template be a useful step to improve things?