docs(demo/readme): add state override warnings

Author: synecdokey

README.md

@@ -97,8 +97,8 @@ Allow the only remaining expanded item to be collapsed.
 
 #### preExpanded: `string[]` [_optional_, default: `[]`]
 
-Accepts an array of strings and any `AccordionItem` whose `uuid` prop matches any one
-of these strings will be expanded on mount.
+Accepts an array of strings and any `AccordionItem` whose `uuid` prop matches
+any one of these strings will be expanded on mount.
 
 #### className : `string` [*optional*, default: `'accordion'`]
 
@@ -121,6 +121,12 @@ Class(es) to apply to element.
 
 Recommended for use with `onChange`. Will be auto-generated if not provided.
 
+#### dangerouslySetExpanding: `boolean` [*optional*]
+
+Enables external control of the expansion.
+
+> Warning: This may impact accessibility negatively, use at your own risk
+
 ---
 
 ### AccordionItemHeading

demo/src/index.tsx

@@ -209,13 +209,14 @@ const App = (): JSX.Element => (
 
         <Accordion>
             {placeholders.map((placeholder: Placeholder, i: number) => {
-                const dangerouslySetExpanded = i < 2 ? true : false;
+                const isExpanded = i < 2;
 
                 return (
                     <AccordionItem
                         key={placeholder.heading}
                         uuid={placeholder.uuid}
-                        dangerouslySetExpanded={dangerouslySetExpanded}
+                        // Warning: This can impact accessibility negatively
+                        dangerouslySetExpanded={isExpanded}
                     >
                         <AccordionItemHeading>
                             <AccordionItemButton>