Merge branch 'main' into dabh/sentence-case-tech-resources

Author: Duncanma

AGENTS.md

@@ -8,6 +8,7 @@ Guidance for AI coding agents working in the [Temporal documentation](https://gi
 |-------|------|
 | Where content belongs | [INFORMATION-ARCHITECTURE.md](./INFORMATION-ARCHITECTURE.md) |
 | React components in MDX | [COMPONENTS.md](./COMPONENTS.md) |
+| Mermaid diagrams | [MERMAID.md](./readme/MERMAID.md) |
 | LLM Markdown pipeline | [MARKDOWN_PIPELINE.md](./MARKDOWN_PIPELINE.md) |
 | Component → Markdown mapping | [COMPONENT_REGISTRY.md](./COMPONENT_REGISTRY.md) |
 

docs/cloud/connectivity/aws-connectivity.mdx

@@ -23,16 +23,6 @@ keywords:
 
 import { CaptionedImage, JsonTable } from '@site/src/components';
 
-<style>{`
-  .docusaurus-mermaid-container .edgeLabel,
-  .docusaurus-mermaid-container .edgeLabel p,
-  .docusaurus-mermaid-container .edgeLabel rect,
-  .docusaurus-mermaid-container .edgeLabel .labelBkg {
-    background-color: var(--ifm-background-color) !important;
-    fill: var(--ifm-background-color) !important;
-  }
-`}</style>
-
 [AWS PrivateLink](https://aws.amazon.com/privatelink/) allows you to open a path to Temporal without opening a public egress.
 It establishes a private connection between your Amazon Virtual Private Cloud (VPC) and Temporal Cloud.
 This one-way connection means Temporal cannot establish a connection back to your service.
@@ -237,10 +227,10 @@ title: Direct VPCE targeting (single region)
 ---
 %%{init: {'themeVariables':{'fontFamily':'Inter, ui-sans-serif, system-ui, sans-serif'},'flowchart':{'nodeSpacing':18,'rankSpacing':45,'curve':'basis','subGraphTitleMargin':{'top':6,'bottom':12}}}}%%
 flowchart LR
-    classDef worker fill:#7C3AED22,stroke:#7C3AED,stroke-width:1px;
-    classDef ns fill:#59FDA024,stroke:#59FDA0,stroke-width:1px;
-    classDef endpoint fill:transparent,stroke:#c2c8d2,stroke-width:1px;
-    classDef region fill:transparent,stroke:#9aa4b2,stroke-width:1.5px;
+    classDef worker stroke-width:1px;
+    classDef ns stroke-width:1px;
+    classDef endpoint stroke-width:1px;
+    classDef region stroke-width:1.5px;
     subgraph SREG["<b>Your VPC</b>"]
       SW["<b>Worker(s)</b><br/>Server name:<br/>my-namespace.my-account.tmprl.cloud"]:::worker
       SVPCE["<b>VPC Endpoint</b><br/>vpce-…"]:::endpoint
@@ -273,10 +263,10 @@ title: Direct VPCE targeting (High Availability)
 ---
 %%{init: {'themeVariables':{'fontFamily':'Inter, ui-sans-serif, system-ui, sans-serif'},'flowchart':{'nodeSpacing':55,'rankSpacing':70,'curve':'basis','subGraphTitleMargin':{'top':6,'bottom':12}}}}%%
 flowchart TD
-    classDef worker fill:#7C3AED22,stroke:#7C3AED,stroke-width:1px;
-    classDef ns fill:#59FDA024,stroke:#59FDA0,stroke-width:1px;
-    classDef endpoint fill:transparent,stroke:#c2c8d2,stroke-width:1px;
-    classDef region fill:transparent,stroke:#9aa4b2,stroke-width:1.5px;
+    classDef worker stroke-width:1px;
+    classDef ns stroke-width:1px;
+    classDef endpoint stroke-width:1px;
+    classDef region stroke-width:1.5px;
     subgraph HSEC["<b>us-west-2</b> (passive)"]
       HWB["<b>Worker(s)</b><br/>Server name<br/><span style='font-family:mono'>namespace.<br/>acct.<br/>tmprl.cloud</span>"]:::worker
       HVPB["<b>VPC<br/>Endpoint</b><br/>vpce-…<br/>us-west-2"]:::endpoint

docs/cloud/high-availability/architecture-patterns.mdx

@@ -55,9 +55,9 @@ sequenceDiagram
     participant W as Workflow
 
     E->>A: POST /webhook (payload)
-    A->>T: signal_with_start(workflow_id, "payment_received", payload)
+    A->>T: signal_with_start(workflow_id,<br/>"payment_received", payload)
     Note over T: Atomic: start if not running, then signal
-    T->>W: Start workflow (if not running) + deliver signal
+    T->>W: Start workflow (if not running)<br/>+ deliver signal
     W->>W: Wake up, process payload
     W->>W: Execute follow-on activities
 ```
@@ -78,7 +78,7 @@ sequenceDiagram
     participant T as Temporal Cluster
     participant E as External Service
 
-    C->>T: Start DelayedCallbackWorkflow(url, data, delay)
+    C->>T: Start DelayedCallbackWorkflow<br/>(url, data, delay)
     T->>W: Schedule first task
     W->>T: workflow.sleep(delay)
     Note over T: Durable timer (survives restarts)
@@ -110,7 +110,7 @@ sequenceDiagram
     A-->>W: Return (workflow paused waiting)
     Note over W: Waiting for external completion...
     E->>CB: POST /callback (result)
-    CB->>W: complete_async_activity(task_token, result)
+    CB->>W: complete_async_activity<br/>(task_token, result)
     W->>W: Resume with result
 ```
 

docs/design-patterns/delayed-callback.mdx

@@ -41,11 +41,11 @@ sequenceDiagram
     participant Temporal as Temporal Service
     participant API as Rate-Limited API
 
-    Workflow->>Temporal: Schedule activity (RetryPolicy: initialInterval=1s)
+    Workflow->>Temporal: Schedule activity<br/>(RetryPolicy: initialInterval=1s)
     Temporal->>+API: Attempt 1
     API-->>-Temporal: HTTP 429 — Retry-After: 60s
-    Note over Temporal: Activity throws ApplicationFailure(nextRetryDelay=60s)
-    Note over Temporal: Override: wait 60s (ignoring RetryPolicy interval)
+    Note over Temporal: Activity throws<br/>ApplicationFailure(nextRetryDelay=60s)
+    Note over Temporal: Override: wait 60s<br/>(ignoring RetryPolicy interval)
     Temporal->>+API: Attempt 2
     API-->>-Temporal: Success
     Temporal-->>Workflow: Result

docs/design-patterns/delayed-retry.mdx

@@ -24,7 +24,7 @@ sequenceDiagram
     rect rgb(230, 235, 250)
         Note over CW,S: Normal Workflow Start
         CW->>S: StartWorkflowExecution
-        S->>S: Matching Service routes task to available Worker
+        S->>S: Matching Service routes<br/>task to available Worker
         S-->>CW: WorkflowTask dispatched via polling
         CW->>CW: Execute WorkflowTask
         CW->>S: Complete WorkflowTask
@@ -33,7 +33,7 @@ sequenceDiagram
     rect rgb(220, 245, 225)
         Note over CW,S: Eager Workflow Start (co-located Worker)
         CW->>S: StartWorkflowExecution (EnableEagerStart=true)
-        S-->>CW: WorkflowTask returned inline — no Matching step
+        S-->>CW: WorkflowTask returned inline<br/>— no Matching step
         CW->>CW: Execute WorkflowTask immediately
         CW->>S: Complete WorkflowTask
     end

docs/design-patterns/eager-workflow-start.mdx

@@ -28,10 +28,10 @@ sequenceDiagram
     S->>W: Schedule WorkflowTask
 
     rect rgb(220, 245, 225)
-        Note over S,W: Phase 1 — Local Activities (in-process, zero server round-trips)
+        Note over S,W: Phase 1 — Local Activities<br/>(in-process, zero server round-trips)
         W->>W: validateTransaction (local)
         W->>W: initTransaction (local)
-        W->>S: Complete WorkflowTask (Phase 1 done, Update result ready)
+        W->>S: Complete WorkflowTask<br/>(Phase 1 done, Update result ready)
     end
 
     S-->>C: Update result returned (~160 ms first response)

docs/design-patterns/early-return-local-activities.mdx

@@ -34,7 +34,7 @@ sequenceDiagram
     Workflow->>Workflow: Validate Input
     alt Validation Fails
         Workflow-->>Client: Error Response
-    else Validation Succeeds
+    else Success
         Workflow->>State: Modify State
         State-->>Workflow: Updated
         Workflow-->>Client: Typed Response

docs/design-patterns/request-response-via-updates.mdx

@@ -38,8 +38,7 @@ sequenceDiagram
         activate W
         T->>W: Deliver Signal
         W->>W: Process Signal
-    end
-    alt Workflow already running
+    else Workflow already running
         T->>W: Deliver Signal only (no start)
         W->>W: Process Signal
     end

docs/design-patterns/signal-with-start.mdx

@@ -39,11 +39,10 @@ flowchart TD
     CAN["continueAsNew\n(startIndex + W)"]
 
     Records --> Parent
-    Parent -->|"start W children"| C1
+    Parent <-->|"start W children /<br/>signal: complete"| C1
     Parent --> C2
     Parent --> C3
 
-    C1 -->|"Signal: complete"| Parent
     Parent -->|"slot free → start next"| C4
 
     Parent -->|"after W children started"| CAN