Docs/advanced streams update 2

[leshy]

recreated prev PR since CI seems confused with it
#1052

[greptile-apps]

Greptile Summary

This PR adds comprehensive documentation and visualization for synchronous value fetching patterns in the sensor streams API. It introduces detailed explanations of getter_hot() and getter_cold() approaches with clear trade-offs, usage examples, and a new pikchr-generated SVG diagram that illustrates the architectural differences between the two patterns.

Key Changes:

• Expanded "Getting Values Synchronously" section with practical context and recommendations
• Added comparison table showing when to use each approach
• Included pikchr diagram source code that generates getter_hot_cold.svg
• Added code examples demonstrating both getter_hot() and getter_cold() usage patterns
• New SVG asset file properly referenced in documentation

All documentation is clear, well-structured, and provides good guidance for developers choosing between synchronous fetching approaches.

Confidence Score: 5/5

• This PR is safe to merge - it contains only documentation and asset additions with no code logic changes
• This PR consists entirely of documentation enhancements and a new SVG diagram. There are no code changes, no logic modifications, and no risk of introducing bugs. The documentation is well-written, technically accurate, and properly formatted. The SVG file is valid and properly referenced in the markdown. The content aligns with the existing documentation style and provides valuable guidance for developers.
• No files require special attention

Important Files Changed

Filename	Overview
docs/api/sensor_streams/advanced_streams.md	Enhanced documentation for synchronous value fetching with detailed explanations of getter_hot() and getter_cold() patterns, including usage examples and a comprehensive comparison table. No issues identified.
docs/api/sensor_streams/assets/getter_hot_cold.svg	New SVG diagram generated from pikchr source code that visualizes the flow and timing differences between getter_hot() (background subscription with instant reads) and getter_cold() (fresh subscription on each call). Diagram is properly formatted and displays correctly.

Sequence Diagram

sequenceDiagram
    participant App as Application
    participant GH as getter_hot()
    participant GC as getter_cold()
    participant Source as Data Source

    rect rgb(92, 159, 240)
    note over GH: Setup (blocking)
    GH->>Source: subscribe()
    Source->>GH: emit value 1
    GH->>GH: cache value
    end

    rect rgb(200, 200, 200)
    note over App: Using getter_hot()
    App->>GH: call()
    GH->>App: return cached value (instant)
    end

    rect rgb(200, 200, 200)
    App->>GH: call()
    GH->>App: return cached value (instant)
    end

    rect rgb(92, 159, 240)
    note over GC: Each call creates new subscription
    GC->>Source: subscribe()
    Source->>GC: emit value
    GC->>App: return value
    GC->>Source: dispose()
    end

    rect rgb(92, 159, 240)
    note over GC: Another call, repeat
    GC->>Source: subscribe()
    Source->>GC: emit value
    GC->>App: return value
    GC->>Source: dispose()
    end

Loading