We need to talk about a convention/pattern for the upgrade instructions, because they need to be there but are too verbose as-is. Perhaps we could put them into <details> sections, where the first line of the breaking change note is the summary line?
@thclark says: