docs: note event bubbling (#3522)

Author: liamdebeasi

docs/api/accordion.md

@@ -36,6 +36,12 @@ import Toggle from '@site/static/usage/v8/accordion/toggle/index.md';
 
 ## Listen for Accordion State Changes
 
+:::caution
+Most `ionChange` events emitted by other components such as [Input](./input) and [Textarea](./textarea) bubble. As a result, these events will bubble up and cause your `ionChange` listener on the Accordion Group to fire if the associated components are used inside of an Accordion.
+
+When using other components that emit `ionChange` inside of Accordion it is recommended to have the `ionChange` callback on Accordion Group check the `target` key on the event passed to the callback to verify that `ionChange` is coming from the Accordion Group and not any descendants.
+:::
+
 Developers can listen for the `ionChange` event to be notified when accordions expand or collapse.
 
 import ListenChanges from '@site/static/usage/v8/accordion/listen-changes/index.md';

plugins/docusaurus-plugin-ionic-component-api/index.js

@@ -168,11 +168,9 @@ function renderEvents({ events }) {
   }
 
   return `
-| Name | Description |
-| --- | --- |
-${events.map((event) => `| \`${event.event}\` | ${formatMultiline(event.docs)} |`).join('\n')}
-
-`;
+| Name | Description | Bubbles |
+| --- | --- | --- |
+${events.map((event) => `| \`${event.event}\` | ${formatMultiline(event.docs)} | \`${event.bubbles}\` |`).join('\n')}`;
 }
 
 function renderMethods({ methods }) {

versioned_docs/version-v7/api/accordion.md

@@ -39,6 +39,12 @@ import Toggle from '@site/static/usage/v7/accordion/toggle/index.md';
 
 ## Listen for Accordion State Changes
 
+:::caution
+Most `ionChange` events emitted by other components such as [Input](./input) and [Textarea](./textarea) bubble. As a result, these events will bubble up and cause your `ionChange` listener on the Accordion Group to fire if the associated components are used inside of an Accordion.
+
+When using other components that emit `ionChange` inside of Accordion it is recommended to have the `ionChange` callback on Accordion Group check the `target` key on the event passed to the callback to verify that `ionChange` is coming from the Accordion Group and not any descendants.
+:::
+
 Developers can listen for the `ionChange` event to be notified when accordions expand or collapse.
 
 import ListenChanges from '@site/static/usage/v7/accordion/listen-changes/index.md';