DOC-6026 improved decision tree

Author: andy-stark-redis

content/integrate/redis-data-integration/when-to-use.md

@@ -70,6 +70,7 @@ questions:
                 outcome:
                     label: "RDI is not necessary for your use case"
                     id: notNecessary
+                    sentiment: "negative"
     writeLocation:
         text: |
             Does your app write data directly to the disk-based database?
@@ -84,6 +85,7 @@ questions:
                 outcome:
                     label: "RDI won't work - your app must write to the primary database"
                     id: wrongWritePattern
+                    sentiment: "negative"
     consistency:
         text: |
             Can your app tolerate eventual consistency in the Redis cache?
@@ -98,6 +100,7 @@ questions:
                 outcome:
                     label: "RDI is not suitable - you need immediate cache consistency"
                     id: needsImmediate
+                    sentiment: "negative"
     throughput:
         text: |
             Will your throughput stay within RDI limits (≤30K records/sec during full sync, ≤10K records/sec during CDC)?
@@ -112,6 +115,7 @@ questions:
                 outcome:
                     label: "RDI throughput limits will be exceeded"
                     id: exceedsLimits
+                    sentiment: "negative"
     dataPattern:
         text: |
             Is your data updated frequently in small increments (not by batch/ETL with large transactions)?
@@ -126,6 +130,7 @@ questions:
                 outcome:
                     label: "RDI will fail with batch/ETL processes and large transactions"
                     id: batchProcessing
+                    sentiment: "negative"
     dataSize:
         text: |
             Is your data set large enough to benefit from caching?
@@ -140,6 +145,7 @@ questions:
                 outcome:
                     label: "RDI is not necessary - your data set is too small"
                     id: tooSmall
+                    sentiment: "negative"
     dataSource:
         text: |
             Is your data ingested from a single source (not from two Active-Active replicas simultaneously)?
@@ -151,11 +157,13 @@ questions:
                 outcome:
                     label: "✅ RDI is a good fit for your use case"
                     id: goodFit
+                    sentiment: "positive"
             no:
                 value: "No"
                 outcome:
                     label: "RDI won't work with Active-Active replicas"
                     id: activeActive
+                    sentiment: "negative"
 ```
 
 

static/js/decision-tree.js

@@ -95,7 +95,8 @@
               depth: depth + 1,
               type: 'outcome',
               text: question.answers.yes.outcome.label || '',
-              answer: 'Yes'
+              answer: 'Yes',
+              sentiment: question.answers.yes.outcome.sentiment || null
             });
           }
         }
@@ -110,7 +111,8 @@
               depth: depth + 1,
               type: 'outcome',
               text: question.answers.no.outcome.label || '',
-              answer: 'No'
+              answer: 'No',
+              sentiment: question.answers.no.outcome.sentiment || null
             });
           }
         }
@@ -204,11 +206,26 @@
       rect.setAttribute('height', item.boxHeight);
 
       if (item.type === 'outcome') {
-        // Outcomes: pale red background, dashed border
-        rect.setAttribute('fill', '#ffe6e6');
-        rect.setAttribute('stroke', '#d9534f');
-        rect.setAttribute('stroke-width', '1');
-        rect.setAttribute('stroke-dasharray', '3,3');
+        // Outcomes: color based on sentiment
+        if (item.sentiment === 'positive') {
+          // Green for positive outcomes
+          rect.setAttribute('fill', '#e6f7f0');
+          rect.setAttribute('stroke', '#0fa869');
+          rect.setAttribute('stroke-width', '1');
+          rect.setAttribute('stroke-dasharray', '3,3');
+        } else if (item.sentiment === 'negative') {
+          // Red for negative outcomes
+          rect.setAttribute('fill', '#ffe6e6');
+          rect.setAttribute('stroke', '#d9534f');
+          rect.setAttribute('stroke-width', '1');
+          rect.setAttribute('stroke-dasharray', '3,3');
+        } else {
+          // Default red for outcomes without explicit sentiment
+          rect.setAttribute('fill', '#ffe6e6');
+          rect.setAttribute('stroke', '#d9534f');
+          rect.setAttribute('stroke-width', '1');
+          rect.setAttribute('stroke-dasharray', '3,3');
+        }
       } else {
         // Questions: standard styling
         rect.setAttribute('fill', '#f5f5f5');

static/schemas/decision-tree.json

@@ -0,0 +1,97 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://redis.io/schemas/decision-tree.json",
+  "title": "Redis Decision Tree Metadata",
+  "description": "Schema for decision tree metadata in Redis documentation",
+  "type": "object",
+  "required": ["type", "id", "scope"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Reference to this schema"
+    },
+    "type": {
+      "type": "string",
+      "enum": ["decision-tree"],
+      "description": "The metadata type"
+    },
+    "id": {
+      "type": "string",
+      "description": "Unique identifier for the decision tree"
+    },
+    "scope": {
+      "type": "string",
+      "description": "Category or domain this tree applies to (e.g., 'documents', 'collections', 'rdi')"
+    },
+    "rootQuestion": {
+      "type": "string",
+      "description": "ID of the starting question"
+    },
+    "questions": {
+      "type": "object",
+      "description": "Object containing all questions, keyed by ID",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["text", "whyAsk", "answers"],
+        "properties": {
+          "text": {
+            "type": "string",
+            "description": "The question text"
+          },
+          "whyAsk": {
+            "type": "string",
+            "description": "Explanation of why this question matters"
+          },
+          "answers": {
+            "type": "object",
+            "required": ["yes", "no"],
+            "properties": {
+              "yes": {
+                "$ref": "#/definitions/answer"
+              },
+              "no": {
+                "$ref": "#/definitions/answer"
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "answer": {
+      "type": "object",
+      "required": ["value"],
+      "properties": {
+        "value": {
+          "type": "string",
+          "description": "Display text (e.g., 'Yes' or 'No')"
+        },
+        "outcome": {
+          "type": "object",
+          "required": ["label", "id"],
+          "properties": {
+            "label": {
+              "type": "string",
+              "description": "The recommendation text"
+            },
+            "id": {
+              "type": "string",
+              "description": "Unique identifier for this outcome"
+            },
+            "sentiment": {
+              "type": "string",
+              "enum": ["positive", "negative"],
+              "description": "Sentiment of the outcome for visual styling (positive=green, negative=red)"
+            }
+          }
+        },
+        "nextQuestion": {
+          "type": "string",
+          "description": "ID of the next question to ask"
+        }
+      }
+    }
+  }
+}
+