I gave the #29546 a try.

  • I divided Destruction Callbacks section into two subsections, one for the inference of destroy methods and the other for the existing documentation on destruction callbacks.
  • I took the liberty to call the latter Explicit destruction methods in opposition to Inferred destruction methods.
  • Inferred destruction methods is written with a Java-first approach, with the the help of the Receiving Lifecycle Callbacks subsection which now references Inferred destruction methods.
  • I updated some references due to the addition of a new subsection.

Comment From: snicoll

Apologizes for missing this @Nheyll but @jhoeller has updated the documentation in the meantime, see #29546