Clarify "account admin" vs "legal representative" wording on company onboarding page

[ntombing]

No description provided.

[linear]

DOC-1694 Clarify "account admin" vs "legal representative" wording on company onboarding page

[netlify]

✅ Deploy Preview for incomparable-tiramisu-91a96a ready!

Name	Link
🔨 Latest commit	164a42d
🔍 Latest deploy log	https://app.netlify.com/projects/incomparable-tiramisu-91a96a/deploys/69e7956aca5bab0008df2c87
😎 Deploy Preview	https://deploy-preview-630--incomparable-tiramisu-91a96a.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[max-koro]

Quick coverage check against the ticket: this PR covers task 1 but targets preview/new-onboarding/legacy-onboarding/company/index.mdx rather than topics/onboarding/company/index.mdx named in the ticket. Can you confirm the Representatives section in the main topics/onboarding/company/index.mdx is also fixed (or moved)? Tasks 2 (full-page audit) and 3 (cross-check against new onboarding v2 where accountAdmin is an API field name) don't appear to be addressed yet

[ntombing]

Quick coverage check against the ticket: this PR covers task 1 but targets preview/new-onboarding/legacy-onboarding/company/index.mdx rather than topics/onboarding/company/index.mdx named in the ticket. Can you confirm the Representatives section in the main topics/onboarding/company/index.mdx is also fixed (or moved)? Tasks 2 (full-page audit) and 3 (cross-check against new onboarding v2 where accountAdmin is an API field name) don't appear to be addressed yet

Hey @max-koro ,

To answer your question: "Can you confirm the Representatives section in the main topics/onboarding/company/index.mdx is also fixed (or moved)? "

No, it wasn't moved to onboarding v2, there's no "Representatives" section. Was this an intentional choice for the v2 updates? We don't have information about UBO's either.

Thanks for the review. These are the changes I made:

Task 1: Rewrite confusing sentence in the Representatives section
File: preview/new-onboarding/legacy-onboarding/company/index.mdx
Rewrote the sentence in #representatives that blurred the distinction between the three concepts:
Before: "This is separate from the legal representative who serves as the account admin and undergoes identification verification."
After: "Representatives are separate from the account's legal representative. The legal representative is the person who administers the Swan account and undergoes identity verification."

Task 2: Full-page audit: consistent terminology
File 1: preview/new-onboarding/legacy-onboarding/company/index.mdx
Updated identification recommendations table header: Recommended level for account admin → Recommended level for legal representative
Updated country requirements intro bullet for "Legal representative information": "The individual who manages the account and undergoes identification" → Legal representative information: The individual who administers the account and undergoes identification
File 2: topics/onboarding/company/index.mdx
Updated identification recommendations table header: Recommended level for account admin → Recommended level for legal representative

Task 3: Cross-check against accountAdmin API field (new onboarding v2)
No changes required. After Tasks 1 and 2, the term "account admin" no longer appears in the prose of either page. The accountAdmin API field is only referenced on the fields subpage, where it is already correctly labelled as "Account administrator (accountAdmin)" — keeping the concept and the field name distinct.