Skip to content

[SK-2630] fix(migration_control_panel): surface steps 3.1/3.2 in TOC and fix an…#9409

Closed
BrenKt wants to merge 1 commit into
developfrom
SK-2630-migration-toc-anchors
Closed

[SK-2630] fix(migration_control_panel): surface steps 3.1/3.2 in TOC and fix an…#9409
BrenKt wants to merge 1 commit into
developfrom
SK-2630-migration-toc-anchors

Conversation

@BrenKt

@BrenKt BrenKt commented Jun 22, 2026

Copy link
Copy Markdown
Contributor

Context

Support feedback (SK-2630) on the MX Plan → Exchange / Email Pro migration guide (KB0053486).
Two issues, same root cause: sub-parts 3.1 and 3.2 were level-4 headings (####).

  1. Table of contents — the OVHcloud TOC only goes down to ###, so 3.1 and 3.2 never showed up. The "3.2 Automatic migration…" section couldn't be anchored to send directly to a customer: they landed on Step 3 and could miss the Roundcube alert callout.
  2. Off-by-one anchors — the <a name> anchors sat inline at the end of the heading line, so internal links (#roundcube-mxplan) landed one line below the heading.

Changes

  • Promote 3.1 / 3.2 from #### to ### → they now appear in the TOC and become anchorable.
  • Move the <a name> anchors onto their own line, just before the heading (already the majority convention in the repo) → links now land on the heading.
  • Demote the two "Migration from…" sub-headings from ##### to #### to keep the hierarchy consistent.

Anchor names are unchanged, so existing internal links keep working.

Scope

Group Locales Treatment
EU de-de, en-gb, en-ie, es-es, fr-fr, it-it, pl-pl, pt-pt 3.1 + 3.2 (all-mxplan / roundcube-mxplan)
CA en-ca (LegacyMxplan / NewVersionMxplan), fr-ca (3.1 only) same, adapted to local anchors
US en-us, es-us no change — flat Step 3 (no Roundcube/Zimbra)

…chors

Steps 3.1 (manual migration) and 3.2 (automatic Roundcube migration) were
level-4 headings, so they never appeared in the table of contents and could
not be linked to when sending the section to a customer. The in-guide anchors
were also placed inline at the end of the heading line, making cross-links land
one line below the heading.

- Promote 3.1/3.2 from #### to ### so they show in the TOC.
- Move <a name> anchors onto their own line above the heading so links land on
  the heading.
- Demote the two "Migration from..." sub-headings from ##### to #### to keep the
  hierarchy consistent.

Applied to all EU locales plus en-ca/fr-ca (US locales have a flat step 3).
@BrenKt BrenKt added FIX The Pull Request contains fixes of code or content (typos) Offer: Web The PR documents Web products: Web Hosting, Domains, DNS, Emais, Web Cloud Databases labels Jun 22, 2026
@BrenKt BrenKt changed the title fix(migration_control_panel): surface steps 3.1/3.2 in TOC and fix an… [SK-2638] fix(migration_control_panel): surface steps 3.1/3.2 in TOC and fix an… Jun 22, 2026
@BrenKt BrenKt changed the title [SK-2638] fix(migration_control_panel): surface steps 3.1/3.2 in TOC and fix an… [SK-2630] fix(migration_control_panel): surface steps 3.1/3.2 in TOC and fix an… Jun 22, 2026
@BrenKt BrenKt closed this Jun 23, 2026
BrenKt added a commit to ovh/ovhcloud-docs that referenced this pull request Jun 24, 2026
[SK-2630] Surface migration steps 3.1/3.2 in the table of contents and fix
anchor positioning in migration-control-panel across 7 locales.

Original-URL: ovh/docs#9409
Original-author: @BrenKt
BrenKt added a commit to ovh/ovhcloud-docs that referenced this pull request Jun 24, 2026
[SK-2630] Surface migration steps 3.1/3.2 in the table of contents and fix
anchor positioning in migration-control-panel across 7 locales.

Original-URL: ovh/docs#9409
Original-author: @BrenKt
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

FIX The Pull Request contains fixes of code or content (typos) Offer: Web The PR documents Web products: Web Hosting, Domains, DNS, Emais, Web Cloud Databases

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant