Skip to content

docs(notifications-category-sync): require marketing section to stay last on mobile - #196

Merged
baptiste-marchand merged 1 commit into
mainfrom
docs/notifications-category-order-marketing-last
Oct 13, 2026
Merged

baptiste-marchand merged 1 commit into
mainfrom
docs/notifications-category-order-marketing-last

Conversation

@baptiste-marchand

@baptiste-marchand baptiste-marchand commented Oct 12, 2026 •

Copy link
Copy Markdown
Contributor

Description

The notifications-category-sync skill's metamask-mobile overlay describes how to register a new section in NOTIFICATION_SETTINGS_SECTIONS, but it did not state where the new entry goes. On mobile, notification settings rows have a product-mandated order in which "Updates and rewards" (marketing) must always render last — new categories are inserted above it, never appended after it.

This PR adds that rule to step 5 (Registry) of domains/platform/skills/notifications-category-sync/repos/metamask-mobile.md, and points to the ordering test (notificationSettingsSections.test.ts) that now asserts the full section order (marketing last) in the mobile repo, so a misplaced entry fails CI.

The rule is mobile-specific (the parent skill.md is client-agnostic), which is why it lives in the repo overlay rather than the parent skill.

Corresponding mobile-repo change (section reorder + ordering test) to be linked once its PR is opened.

Type of Change

  • New skill
  • Skill improvement/update
  • Bug fix
  • Documentation update
  • Other (please describe):

Skill Details (if adding a new skill)

N/A — update to an existing skill overlay.

Checklist

  • I have read the CONTRIBUTING.md guidelines
  • My skill follows the SKILL_TEMPLATE.md format
  • I have tested this skill with an AI agent
  • My skill does not contain any secrets, private keys, or sensitive data
  • I have added appropriate documentation
  • My changes don't break existing skills

Testing

The updated step was followed end-to-end in metamask-mobile to reorder its notification settings sections (Wallet activity, Trading activity, Trading signals, Price alerts, Agent wallet, Updates and rewards last). The ordering test added in the mobile repo passes, and lint / type check are clean; a misplaced registry entry now fails CI as the skill states.

Additional Context

Section order in question (mobile settings screen):

  1. Wallet activity
  2. Trading activity
  3. Trading signals
  4. Price alerts
  5. Agent wallet
  6. Updates and rewards (always last)

…last on mobile

The 'Updates and rewards' (marketing) settings row must always render last in metamask-mobile's notification settings. New categories are inserted above it. This is now enforced in the mobile repo by an ordering test in notificationSettingsSections.test.ts, so a misplaced registry entry fails CI.
@baptiste-marchand baptiste-marchand self-assigned this Oct 12, 2026
@baptiste-marchand
baptiste-marchand marked this pull request as ready for review October 12, 2026 09:53
@baptiste-marchand
baptiste-marchand merged commit cb7f758 into main Oct 13, 2026
28 checks passed
@baptiste-marchand
baptiste-marchand deleted the docs/notifications-category-order-marketing-last branch October 13, 2026 09:21
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.

2 participants