<details> toggle event improvements (#33750)

files/en-us/web/api/htmldetailselement/toggle_event/index.md

@@ -18,15 +18,23 @@ This event is not cancelable and does not bubble.
 
 Use the event name in methods like {{domxref("EventTarget.addEventListener", "addEventListener()")}}, or set an event handler property.
 
-```js
+```js example-good
 addEventListener("toggle", (event) => {});
 
 ontoggle = (event) => {};
 ```
 
+```html example-bad
+<details ontoggle="console.log(this.open)" open>...</details>
+```
+
+> **Note:** In the example above the event listener will be called once without any user interaction because the `open` attribute is set. Using event handlers like this [is discouraged](/en-US/docs/Web/HTML/Attributes#event_handler_attributes).
+
 ## Event type
 
-A generic {{domxref("Event")}}.
+A {{domxref("ToggleEvent")}}. Inherits from {{domxref("Event")}}.
+
+{{InheritanceDiagram("ToggleEvent")}}
 
 ## Examples