docs(alert,note): ontwerprationale neutral variant verduidelijkt

Legt uit waarom Alert geen neutral variant heeft (systeemfeedback heeft
altijd een toon) en waarom Note neutral als default heeft (redactioneel
geplaatst, visuele nadruk zonder semantisch signaal).

Tevens 'Don't use when' in Alert aangevuld: gebruik Note wanneer de
content contextgevend is zonder dat het systeem een toestand meldt.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: Jeffrey Lauwers

packages/storybook/src/Alert.docs.md

@@ -21,11 +21,14 @@ De Alert component toont een prominent bericht op de pagina — bij een succesvo
 - Het bericht interactief is (bijv. een link of knop vereist) — gebruik een **Alert** met `children` die een link bevatten, of een **Button** als de actie centraal staat.
 - Je een klein inline statuslabel wilt — gebruik een **StatusBadge**.
 - Het bericht tijdelijk is en na enkele seconden verdwijnt — gebruik een toast/snackbar patroon (nog niet beschikbaar).
+- De content redactioneel of contextgevend is zonder dat het systeem een toestand meldt — gebruik een **Note**.
 
 ## Best practices
 
 ### Variantkeuze
 
+Een Alert communiceert altijd een toestand die het systeem heeft vastgesteld. Elke variant draagt daarmee een expliciet semantisch signaal: iets is gelukt, mislukt, in behandeling of vereist aandacht. Een neutrale variant ontbreekt bewust — als het systeem iets te melden heeft, is er altijd een toon. Zonder toon is er geen reden voor een Alert.
+
 - **Info** — standaard, voor informatieve berichten zonder urgentie (`"Uw aanvraag wordt verwerkt"`).
 - **Positive** — succesberichten na een geslaagde actie (`"Uw gegevens zijn opgeslagen"`).
 - **Negative** — fout- of validatieberichten (`"Er zijn fouten opgetreden"`).

packages/storybook/src/Note.docs.md

@@ -25,7 +25,9 @@ De Note component plaatst extra context of een tip op een opvallende maar niet-u
 
 ### Variantkeuze
 
-- **Neutral** — standaard, voor algemene tips en aanvullende context.
+Een Note wordt bewust door een ontwerper of ontwikkelaar geplaatst. De variant kies je op basis van de intentie van de boodschap — niet op basis van een systeemtoestand. Wanneer een notitie puur aanvullend of contextgevend is, zonder specifieke lading, dan is **neutral** de juiste keuze: de content krijgt visuele nadruk zonder een semantisch signaal te claimen dat er niet is.
+
+- **Neutral** — standaard, voor aanvullende context of tips zonder specifieke lading.
 - **Info** — informatieve berichten die extra aandacht verdienen.
 - **Positive** — aanmoediging of bevestiging van een goede keuze.
 - **Negative** — kritische aanvulling, risico of fout in context.