Skip to content

CQA 11th March - TOC fix#882

Open
anarnold97 wants to merge 2 commits into
kubev2v:mainfrom
anarnold97:CQA-11March-TOC
Open

CQA 11th March - TOC fix#882
anarnold97 wants to merge 2 commits into
kubev2v:mainfrom
anarnold97:CQA-11March-TOC

Conversation

@anarnold97

@anarnold97 anarnold97 commented Mar 11, 2026

Copy link
Copy Markdown
Collaborator

PREVIEWS

Summary of changes to documentation .adoc files

Only assembly files under documentation/doc-*/assemblies/ were modified. No module files (e.g. modules/*.adoc) were changed.
Change: For every include that points to a *-toc-sections.adoc module, the attribute was updated from [leveloffset=0] to [leveloffset=+1].
Scope: 10 assembly files, 17 include lines in total.

Assembly Includes updated
assembly_cold-warm-migration.adoc 2
assembly_provider-specific-requirements-for-migration.adoc 2
assembly_understanding-mtv-migration.adoc 2
assembly_planning-migration-vmware.adoc 3
assembly_software-requirements-for-migration.adoc 1
assembly_migrating-vms-web-console.adoc 2
assembly_migrating-from-vmware.adoc 1
assembly_mtv-performance-recommendations.adoc 2
assembly_troubleshooting-migration.adoc 1
assembly_advanced-migration-options.adoc 1
Unchanged: Include paths, order of includes, and all other content in assemblies and modules. Only the leveloffset value on those 17 toc-sections include lines was updated.

@vercel

vercel Bot commented Mar 11, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
forklift-documentation Ready Ready Preview, Comment Mar 18, 2026 5:08pm

@@ -9,21 +9,3 @@

[role="_abstract"]

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looking at the preview...
2.2.1 Warm migration is nested under 2.2 Cold migration. It should be at the same level, so 2.3.
2.4. Warm migration stages (this file) is duplicate content and the file can be deleted altogether.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agree with Jenny-Anne -- so I think we'd want:
2.3 Warm migration
2.3.1 Precopy stage
2.3.2 Cutover stage

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@RichardHoch So can you take ownership of this PR - gh pr checkout 882 and make those change, please

Signed-off-by: A.Arnold <anarnold@redhat.com>
include::../modules/about-storage-copy-offload.adoc[leveloffset=+1]

include::../modules/about-storage-copy-offload-toc-sections.adoc[leveloffset=+1]

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this should be leveloffset=+2. That will keep the same taxonomy as the current document.

include::../modules/compatibility-guidelines.adoc[leveloffset=+1]

include::../modules/compatibility-guidelines-toc-sections.adoc[leveloffset=+1]

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Currently, compatibility-guidelines-toc-sections is nestled under compatibility-guidelines, which I think makes sense. If you agree, then the leveloffset of compatibility-guidelines-toc-sections sshould be +2.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants