Hey,
if the upgrade path is confusing then i think it could be the best to contact the ownCloud team at their bugtracker asking for some clarification.
The one for the documentation (if there are confusing parts in the documentation) is available at https://github.com/owncloud/docs/issues where the tracker for the updater app (which seems to be responsible for the updating mechanism) is available at https://github.com/owncloud/updater/issues