Description

Clarify the @deprecated notice on ButtonLink so migration paths are explicit and unambiguous:

• Use TextButton for inline links within text flows
• Use Button with variant={ButtonVariant.Tertiary} for standalone link‑style buttons (CTAs, headers, separators)

Adds concise inline examples and links to design‑system docs. No runtime behavior changes (comment‑only).

Context: Slack thread

Changelog

CHANGELOG entry: null

Related issues

Fixes:

Manual testing steps

N/A (documentation‑only change)

Screenshots/Recordings

Before

N/A

After

N/A

Pre-merge author checklist

• I've followed MetaMask Contributor Docs and MetaMask Mobile Coding Standards.
• I've completed the PR template to the best of my ability
• I've included tests if applicable
• I've documented my code using JSDoc format if applicable
• I've applied the right labels on the PR (see labeling guidelines). Not required for external contributors.

Pre-merge reviewer checklist

• I've manually tested the PR (e.g. pull and build branch, run the app, test code being changed).
• I confirm that this PR addresses all acceptance criteria described in the ticket it closes and includes the necessary testing evidence such as recordings and or screenshots.

Slack Thread