difference between "do-release-upgrade" and "apt-get dist-upgrade"

[Amedee Van Gasse (ub)]

I've spent the last few minutes looking for the difference between
"do-release-upgrade" and "apt-get dist-upgrade".

I *know* that there is a difference.
I *know* that "do-release-upgrade" is recommended over editing
sources.list and running "apt-get dist-upgrade".
I can explain it in my own words.

But I am unable to find any *official* documentation on the Ubuntu
website, or developer notes, that explain *why*. Something that explains
in detail *what* it is exactly that "do-release-upgrade" does.

Something that I can link to.


Amedee.