Skip to content

[SK-2630] docs: surface migration steps 3.1/3.2 in TOC + fix anchors (new-docs port) - #251

Merged
BrenKt merged 1 commit into
developfrom
SK-2630-port-toc-anchors
Jun 24, 2026
Merged

[SK-2630] docs: surface migration steps 3.1/3.2 in TOC + fix anchors (new-docs port)#251
BrenKt merged 1 commit into
developfrom
SK-2630-port-toc-anchors

Conversation

@BrenKt

@BrenKt BrenKt commented Jun 23, 2026

Copy link
Copy Markdown
Collaborator

Port of legacy PR ovh/docs#9409 to new-docs.

Context

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

  1. TOC — the OVHcloud TOC only goes down to ###, so 3.1/3.2 never appeared and couldn't be anchored to send a customer the "3.2 Automatic migration" section (they landed on Step 3 and could miss the Roundcube alert callout).
  2. Off-by-one anchors<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 ### → visible in the TOC and anchorable.
  • Move <a name> anchors onto their own line, before the heading → links land on the heading.
  • Demote the two "Migration from…" sub-headings ######### for hierarchy.

Anchor names unchanged → existing internal links keep working. Purely structural; no images, no syntax conversion needed.

Scope

7 locales (en, fr, de, es, it, pl, pt) — all real files, no symlinks. New-docs content matched the legacy base exactly → clean port, no divergence.

@BrenKt BrenKt added Web Cloud The PR documents Web Cloud products: Domains/DNS, Web Hosting, Emails, Web Cloud Databases FIX / CHORE Updates to maintain/fix the documentation front-end or back-end labels Jun 23, 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
BrenKt force-pushed the SK-2630-port-toc-anchors branch from 1ac69a6 to 1b867e5 Compare June 24, 2026 14:03
@BrenKt
BrenKt marked this pull request as ready for review June 24, 2026 14:29
@BrenKt
BrenKt merged commit e8a532d into develop Jun 24, 2026
1 check passed
@BrenKt
BrenKt deleted the SK-2630-port-toc-anchors branch June 24, 2026 14:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

FIX / CHORE Updates to maintain/fix the documentation front-end or back-end Web Cloud The PR documents Web Cloud products: Domains/DNS, Web Hosting, Emails, Web Cloud Databases

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant