diff --git a/documentation/docs/97-best-practices/10-best-practices.md b/documentation/docs/97-best-practices/10-best-practices.md
index 8b593c9953..d4d6c50045 100644
--- a/documentation/docs/97-best-practices/10-best-practices.md
+++ b/documentation/docs/97-best-practices/10-best-practices.md
@@ -54,7 +54,11 @@ to allow `<MyComponent bind:value />`. This can get hairy when the value of the
 
 ## Events on elements
 
-Every prop that starts with `on` is treated as an event listener for the element. To register a `click` listener on an element you can do `<button onclick={()=>{}} />` (NOTE: in svelte 5 there's no colon between `on` and `click`). Since elements are just attributes you can spread them, use the `{onclick}` shorthand etc.
+Every prop that starts with `on` is treated as an event listener for the element. To register a `click` listener on an element you can do `<button onclick={() => {}} />` 
+
+> [!NOTE] In Svelte 5, `on` is no longer a directive, so you can't use `on:event`, you have to use `onevent`. 
+
+Since elements are just attributes you can spread them, use the `{onclick}` shorthand, etc.
 
 If you need to attach listeners to `window` or `document` use `<svelte:window onclick>` or `<svelte:document onclick>` instead of using `onMount`/`$effect`