The trajectory is clear:

: There is no official "cookbook" or documentation for creating upgrade-safe addons. Maintenance Challenges