priority and fairness interactive simulator [experimentation]

docs/develop/priority-fairness-walkthrough.mdx

@@ -0,0 +1,20 @@
+---
+id: priority-fairness-walkthrough
+title: Task Queue Priority and Fairness - Interactive Walkthrough
+sidebar_label: Priority and Fairness
+description: Interactively explore how Task Queue Priority and Fairness control dispatch order. Step through scenarios, see which task gets picked next and why, then grab the SDK code.
+toc_max_heading_level: 2
+keywords:
+  - task queue priority
+  - task queue fairness
+  - priority key
+  - fairness key
+  - interactive demo
+tags:
+  - Task Queues
+  - Priority and Fairness
+---
+
+import { PriorityFairnessWalkthrough } from '@site/src/components';
+
+<PriorityFairnessWalkthrough />

sidebars.js

@@ -890,6 +890,15 @@ module.exports = {
       ],
     },
     'glossary',
+    {
+      type: 'category',
+      label: 'Interactive Demos',
+      collapsed: false,
+      items: [
+        'develop/activity-retry-simulator',
+        'develop/priority-fairness-walkthrough',
+      ],
+    },
     'with-ai',
     // {
     //   type: "autogenerated",