You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@mesos.apache.org by Jörg Schad <jo...@mesosphere.io> on 2016/03/12 11:45:58 UTC

Improving the Upgrade Documentation

We are currently working on improving the upgrade documentation and started
by adding an overview section
<https://github.com/apache/mesos/blob/master/docs/upgrades.md> where the
you can easily see potential changes/incompatibilities in different areas.
We know that the rendering of the table isn't optimal yet but will continue
working on this.

If you have any feedback on this or how we can improve the upgrade guide
further, let us know!

Thanks!

Re: Improving the Upgrade Documentation

Posted by Shuai Lin <li...@gmail.com>.
One thing I would strongly recommend is to add to the doc is "not to skip
versions when upgrading" as commented by Adam in this thread:
https://mail-archives.apache.org/mod_mbox/mesos-user/201512.mbox/%3CCAK8jAgNBPhPh7vSo+p8oVPupMDDd93ZnxyyvHXKqEcaNHQk6WQ@mail.gmail.com%3E
.

With the recently release cycle being 5~6 weeks, I believe it's a common
case to upgrade from version N to version N + 3 or even N + 4. It would
save them lots of time if we make it clear not to skip versions when
upgrading.

On Sat, Mar 12, 2016 at 6:45 PM, Jörg Schad <jo...@mesosphere.io> wrote:

> We are currently working on improving the upgrade documentation and started
> by adding an overview section
> <https://github.com/apache/mesos/blob/master/docs/upgrades.md> where the
> you can easily see potential changes/incompatibilities in different areas.
> We know that the rendering of the table isn't optimal yet but will continue
> working on this.
>
> If you have any feedback on this or how we can improve the upgrade guide
> further, let us know!
>
> Thanks!
>

Re: Improving the Upgrade Documentation

Posted by Shuai Lin <li...@gmail.com>.
One thing I would strongly recommend is to add to the doc is "not to skip
versions when upgrading" as commented by Adam in this thread:
https://mail-archives.apache.org/mod_mbox/mesos-user/201512.mbox/%3CCAK8jAgNBPhPh7vSo+p8oVPupMDDd93ZnxyyvHXKqEcaNHQk6WQ@mail.gmail.com%3E
.

With the recently release cycle being 5~6 weeks, I believe it's a common
case to upgrade from version N to version N + 3 or even N + 4. It would
save them lots of time if we make it clear not to skip versions when
upgrading.

On Sat, Mar 12, 2016 at 6:45 PM, Jörg Schad <jo...@mesosphere.io> wrote:

> We are currently working on improving the upgrade documentation and started
> by adding an overview section
> <https://github.com/apache/mesos/blob/master/docs/upgrades.md> where the
> you can easily see potential changes/incompatibilities in different areas.
> We know that the rendering of the table isn't optimal yet but will continue
> working on this.
>
> If you have any feedback on this or how we can improve the upgrade guide
> further, let us know!
>
> Thanks!
>