chore(ReactFlow): updated guidance for a11y

packages/documentation-site/patternfly-docs/content/AI/Compass/CompassReactFlowDemo.tsx

@@ -227,6 +227,7 @@ const AddNodeOnEdgeDrop = () => {
         fitView
         fitViewOptions={{ padding: 2 }}
         nodeOrigin={nodeOrigin}
+        aria-label="React flow demo"
       >
         <Background />
       </ReactFlow>

packages/documentation-site/patternfly-docs/content/AI/Compass/ReactFlow.md

@@ -23,7 +23,7 @@ import {
 import "@xyflow/react/dist/style.css";
 import "./reactFlowOverrides.css";
 
-### React Flow
+### React Flow and PatternFly tokens
 
 The React Flow package `@xyflow/react` is compatible with PatternFly through customization of its [theme](https://reactflow.dev/learn/customization/theming) and [rendered nodes](https://reactflow.dev/learn/customization/custom-nodes). A custom override stylesheet can assign PatternFly's global tokens to React Flow's own tokens to ensure a consistent styling. The following is a basic list of overrides used by the example, which also renders custom nodes using PatternFly's `Card` components:
 
@@ -48,4 +48,16 @@ The React Flow package `@xyflow/react` is compatible with PatternFly through cus
 | --xy-handle-border-color-default | var(--pf-t--global--border--color--alt) |
 
 ```js file="./CompassReactFlowDemo.tsx"
-```
+```
+
+### Accessibility considerations
+
+While React Flow is built with accessibility in mind, you should always check that your implementation (when paired with PatternFly) is accessible via mouse, keyboard, and other assistive technologies like screen readers. 
+
+Additionally, you should align with the following practices: 
+
+- Provide an accessible name to the `<ReactFlow>` component, if its default role of "application" is kept or if it is given another semantic role that requires an accessible name.
+- Because React Flow supports node clicking and dragging, ensure that actions within draggable nodes are large enough to prevent misclicks (for example, kebab toggles, links, or other action buttons).
+  -  [WCAG 2.5.8: Target size (Minimum)](https://www.w3.org/WAI/WCAG22/Understanding/target-size-minimum) requires targets to be at least 24 by 24 CSS pixels. While there are exceptions, you should still aim for this minimum because a React Flow node itself can be clicked for some actions. This is especially important for an action like opening a details drawer upon a quick click to a node.
+- Ensure that any actions that can be taken via mouse only can be taken via keyboard as well, including all actions within a node and node repositioning via dragging.
+  - Dragging nodes via keyboard should be built into React Flow itself by default, but always double check to confirm.