improvement(docs): loop and parallel var reference syntax

[icecrasher321]

Summary

Add subflow variable reference syntax into the docs.

Type of Change

• Documentation

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
docs	Ready	Preview, Comment	Jan 24, 2026 7:30pm

[greptile-apps]

Greptile Summary

This PR enhances the documentation for loop and parallel blocks by adding comprehensive explanations of variable reference syntax. The changes clarify the distinction between inside and outside references for both blocks, provide accurate code examples, and fix an incorrect syntax example in the parallel block documentation.

• Added tabbed sections to loop.mdx distinguishing inside-loop vs outside-loop variable references, with clear examples for each context
• Added similar tabbed sections to parallel.mdx for inside-parallel vs outside-parallel references
• Fixed incorrect syntax in parallel.mdx's Result Aggregation section (changed from input.parallel.results to <processtasks.results>)
• Updated variable syntax formatting to use proper JSX interpolation format ({"<loop.index>"}) throughout the Variables tabs
• Clarified that certain variables (currentItem, items) are only available for specific loop/parallel types
• All documented syntax is verified against the actual implementation in resolver test files

Confidence Score: 5/5

• This PR is safe to merge with no technical concerns or errors.
• Score reflects the purely documentation-focused nature of this PR with no code changes, all documented syntax verified against implementation tests, accurate examples for both loop and parallel blocks, and a helpful bug fix in the parallel documentation. The changes improve clarity and provide users with complete and accurate information.
• No files require special attention. Both documentation files are well-structured, accurate, and consistent with the codebase implementation.

Important Files Changed

Filename	Overview
apps/docs/content/docs/en/blocks/loop.mdx	Enhanced documentation with comprehensive explanation of loop variable references, distinguishing between inside-loop variables (<loop.index>, <loop.currentItem>, <loop.items>) and outside-loop results (<blockname.results>). All syntax and examples are accurate and verified against implementation.
apps/docs/content/docs/en/blocks/parallel.mdx	Enhanced documentation with clear explanation of parallel variable references, distinguishing between inside-parallel variables (<parallel.index>, <parallel.currentItem>, <parallel.items>) and outside-parallel results (<blockname.results>). Fixed incorrect syntax in Result Aggregation example from input.parallel.results to <processtasks.results> for consistency with actual implementation.

Sequence Diagram

sequenceDiagram
    participant Code as User Code
    participant Inside as Inside Loop
    participant Outside as Outside Loop
    participant Resolver as Variable Resolver

    Code->>Inside: "Use <loop.index>"
    Inside->>Resolver: "Resolve <loop.index>"
    Resolver->>Inside: "Returns: 0, 1, 2..."

    Code->>Inside: "Use <loop.currentItem>"
    Inside->>Resolver: "Resolve <loop.currentItem>"
    Resolver->>Inside: "Returns: Item data"

    Code->>Inside: "Use <loop.items>"
    Inside->>Resolver: "Resolve <loop.items>"
    Resolver->>Inside: "Returns: Full collection"

    Code->>Outside: "Use <blockname.results>"
    Outside->>Resolver: "Resolve block reference"
    Resolver->>Outside: "Returns: [result1, result2...]"

    Note over Code,Resolver: Inside: <loop.X> | Outside: <blockname.results>

Loading