MetaMask / MetaMask/metamask-docs

Notifications page switches code style without explanation (plain JS to JSX)

Open Beginner friendly
#2,895 2 comments 0 reactions 0 assignees View on GitHub
Dominant language
MDX
Stars
861
Forks
2.1k
Avg merge
6d 10h
Merged PRs (30d)
10

Description

## Description
The Notifications feature page shows two code examples that use inconsistent
styles without explaining why.

- The basic `snap_notify` example (Step 2) uses plain JavaScript.
- The "Expanded view" example immediately below uses JSX components
(``, ``) with no explanation that JSX is required for
expanded view content.

This is confusing for new developers who don't understand why the two
examples look so different.

## Page URL
https://docs.metamask.io/snaps/features/notifications/

## Suggested fix
Add a brief note before the expanded view example clarifying that the
`content` field requires JSX (or the functions-based equivalent),
and link to the Custom UI docs for context.

Contributor guide

Open the contributing guide

Research direction

Open the Notifications feature page at the provided URL and compare the Step 2 and Expanded view examples. Add the requested explanation that expanded-view content requires JSX or the functions-based equivalent, link to the Custom UI docs, and verify the rendered documentation is clear.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
78/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.