Arvados

ready for review at d4e10c0482b28a1c2fb7ef48e69a673d2c6ea15a on branch 18702-document-upgrades

All the references to configuration centralization refer to https://doc.arvados.org/v2.1 but the last one in file doc/admin/upgrading.html.textile.liquid, which refers to https://doc.arvados.org/v2.0. Is that intentional?

-Arvados is migrating to a centralized configuration file for all components.  During the migration, legacy configuration files will continue to be loaded.  See "Migrating Configuration":config-migration.html for details.
+Arvados is migrating to a centralized configuration file for all components.  During the migration, legacy configuration files will continue to be loaded.  See "Migrating Configuration":https://doc.arvados.org/v2.0/config-migration.html for details.

Other than that, it LGTM.

I gave it a quick look, the one thing I noticed was that the "Upgrading" page has a section on "general process" with 6 steps and then the new "Maintenance and upgrading" has its own 4 steps. It does refer to the 1st one but it isn't exactly clear how the two checklists should mesh. Seems like that could be consolidated into one set of steps in one place?

Javier Bértoli wrote:

All the references to configuration centralization refer to https://doc.arvados.org/v2.1 but the last one in file doc/admin/upgrading.html.textile.liquid, which refers to https://doc.arvados.org/v2.0. Is that intentional?

[...]

Other than that, it LGTM.

Ah, good catch, I fixed that in 09c022661e08acbb560b4969f1127012d987b94e

Peter Amstutz wrote:

I gave it a quick look, the one thing I noticed was that the "Upgrading" page has a section on "general process" with 6 steps and then the new "Maintenance and upgrading" has its own 4 steps. It does refer to the 1st one but it isn't exactly clear how the two checklists should mesh. Seems like that could be consolidated into one set of steps in one place?

Oh, yeah, good point. I've done this in 70d4cba7d4aef3063fb549a77b45951c339cc57c on branch 18702-document-upgrades

Ward Vandewege wrote:

Peter Amstutz wrote:

I gave it a quick look, the one thing I noticed was that the "Upgrading" page has a section on "general process" with 6 steps and then the new "Maintenance and upgrading" has its own 4 steps. It does refer to the 1st one but it isn't exactly clear how the two checklists should mesh. Seems like that could be consolidated into one set of steps in one place?

Oh, yeah, good point. I've done this in 70d4cba7d4aef3063fb549a77b45951c339cc57c on branch 18702-document-upgrades

this LGTM, thanks

Peter Amstutz wrote:

Ward Vandewege wrote:

Peter Amstutz wrote:

I gave it a quick look, the one thing I noticed was that the "Upgrading" page has a section on "general process" with 6 steps and then the new "Maintenance and upgrading" has its own 4 steps. It does refer to the 1st one but it isn't exactly clear how the two checklists should mesh. Seems like that could be consolidated into one set of steps in one place?

Oh, yeah, good point. I've done this in 70d4cba7d4aef3063fb549a77b45951c339cc57c on branch 18702-document-upgrades

this LGTM, thanks

Thanks, merged!