e91cf98f8f
Five documentation deliverables for the ElkSharp rendering improvements: 1. docs/workflow/engine/16-elksharp-rendering-architecture.md (453 lines) Full pipeline: Sugiyama stages, edge routing strategies, hybrid deterministic mode, gateway geometry, 18-category scoring system, corridor routing, Y-gutter expansion, diagnostics. 2. docs/workflow/engine/17-elksharp-architectural-decisions.md (259 lines) Six ADRs: short-stub normalization, gateway vertex entries, Y-gutter expansion, corridor rerouting, FinalScore adjustment, alongside detection. 3. docs/workflow/tutorials/10-rendering/README.md (234 lines) Practical tutorial: setup, layout options, SVG/PNG rendering, diagnostics capture, violation reports, full end-to-end example. 4. src/__Libraries/StellaOps.ElkSharp/AGENTS.md — 7 new local rules for Y-gutter, corridor reroute, gateway vertices, FinalScore adjustments, short-stub normalization, alongside detection, target-join spread. 5. docs/workflow/ENGINE.md — replaced monolithic ElkSharp paragraph with structured pipeline overview, effort-level table, and links to the new architecture docs. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Workflow Declaration Tutorials
Step-by-step tutorials for building workflows with the Serdica Workflow Engine. Each tutorial is available in both C# fluent DSL and canonical JSON variants.
Reference Documentation
- Engine Reference Manual - Architecture, configuration, service surface, timeout model, signal system
- Fluent DSL Syntax Guide - Complete DSL method reference
Tutorials
| # | Tutorial | C# | JSON | Topics |
|---|---|---|---|---|
| 01 | Hello World | C# | JSON | Minimal workflow, single task, state init |
| 02 | Service Tasks | C# | JSON | Transport calls, addresses, failure/timeout handling |
| 03 | Decisions | C# | JSON | WhenExpression, WhenStateFlag, nested branching |
| 04 | Human Tasks | C# | JSON | Approve/reject, OnComplete, re-activation, deadlines |
| 05 | Sub-Workflows | C# | JSON | SubWorkflow vs ContinueWith, state flow |
| 06 | Advanced Patterns | C# | JSON | Fork, Repeat, Timer, External Signal |
| 07 | Shared Helpers | C# | - | Address registries, payload builders, extensions |
| 08 | Expressions | C# | JSON | Path navigation, functions, operators |
| 09 | Testing | C# | - | Recording transports, task completion, assertions |
How to Read
Each tutorial folder contains:
README.md- Explanation, concepts, and what to expectcsharp/- C# fluent DSL examplesjson/- Equivalent canonical JSON definitions (where applicable)
Start with Tutorial 01 and progress sequentially. Tutorials 07 (Shared Helpers) and 09 (Testing) are C#-only since they cover code organization and test infrastructure.