Add 3.0 to 3.1 migration documentation #456
Conversation
asciidoc/day2/migration.adoc
Outdated
| === Migration steps | ||
|
|
||
| After executing the <<day2-migration-downstream-prerequisites, prerequisite>> steps, you can proceed to follow the <<day2-downstream-clusters, downstream cluster>> upgrade documentation for the `Edge 3.1` release. |
There was a problem hiding this comment.
Do we need this section?
There was a problem hiding this comment.
IMO, yes. This marks the logical next step to the downstream cluster update mechanism. Without it users will not be sure where to proceed once the prerequisite steps have concluded.
There was a problem hiding this comment.
This might be somewhat related to #456 (comment) and how we lay out the structure itself.
There was a problem hiding this comment.
@ipetrov117 I have a few suggestions.
Apart from that, I will need to review the local PDF version of the document to let you know about the sections and sub sections. Can you please upload it here? Else, I will generate a PDF and check if it the sections and sub sections look okay.
| For a list of `Edge 3.1` component versions, refer to the <<release-notes, release notes>>. | ||
|
|
||
| [#day2-migration-mgmt] | ||
| == Management cluster |
There was a problem hiding this comment.
can you please share the locally generated PDF of this content? That would help me to assess the TOC, sub sections.
| [#day2-migration-mgmt] | ||
| == Management cluster | ||
|
|
||
| This section covers how to migrate a `management` cluster from `Edge 3.0` to `Edge 3.1.0`. |
There was a problem hiding this comment.
please help me understand. Are we creating Edge 3.1.0? or Just 3.1? The reason I ask is because for Edge 3.0, only Edge 3.0 was created and not 3.0.0.
There was a problem hiding this comment.
We are migrating a 3.0 cluster to the Edge 3.1.0 release. I am not sure what the best versioning convention should be here. Lemme know if I should change this to 3.1 instead.
Adds migration documentation to our "Day 2" docs that specifies the steps users should take in order to migrate their 3.0.X Edge environments to Edge 3.1.