Update documentation for v3.5.6 release

- Updated version references from v3.3.4/v3.5.5 to v3.5.6
- Added event forwarding architecture details in trading-suite.md
- Documented automatic price alignment for bracket orders
- Explained multi-instrument event handling with forwarding
- Added notes about InstrumentContext event methods (on, once, off, wait_for)

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: TexasCoding

docs/examples/advanced.md

@@ -1,6 +1,6 @@
 # Advanced Trading Examples
 
-This page demonstrates sophisticated trading strategies and advanced features of the ProjectX Python SDK v3.3.4. These examples include order placement, risk management, and complex event-driven trading systems.
+This page demonstrates sophisticated trading strategies and advanced features of the ProjectX Python SDK v3.5.6. These examples include order placement with automatic price alignment, risk management, and complex event-driven trading systems with proper multi-instrument event forwarding.
 
 !!! warning "Live Trading Alert"
     **These examples place REAL ORDERS on the market!**

docs/examples/realtime.md

@@ -1,6 +1,6 @@
 # Real-time Data Processing Examples
 
-This page demonstrates how to work with real-time market data streams using the ProjectX Python SDK v3.3.4. Learn to handle WebSocket data, process multiple timeframes, and build real-time trading systems.
+This page demonstrates how to work with real-time market data streams using the ProjectX Python SDK v3.5.6. Learn to handle WebSocket data, process multiple timeframes, and build real-time trading systems with the enhanced event system.
 
 ## Prerequisites
 

docs/guide/realtime.md

@@ -1,6 +1,6 @@
 # Real-time Data Guide
 
-This guide covers comprehensive real-time data streaming using ProjectX Python SDK v3.3.4+. All real-time operations are fully asynchronous and provide high-performance WebSocket connectivity with automatic reconnection and memory management.
+This guide covers comprehensive real-time data streaming using ProjectX Python SDK v3.5.6+. All real-time operations are fully asynchronous and provide high-performance WebSocket connectivity with automatic reconnection, memory management, and enhanced event forwarding for multi-instrument support.
 
 ## Overview
 

docs/guide/trading-suite.md

@@ -538,6 +538,14 @@ async def risk_manager_feature():
 
 ## Event Handling
 
+### Event System Architecture (v3.5.6+)
+
+The event system in v3.5.6+ features automatic event forwarding from instrument-specific EventBuses to the suite-level EventBus, enabling flexible event handling patterns:
+
+- **Instrument-level events**: Each instrument has its own EventBus for isolated event handling
+- **Suite-level events**: All instrument events are forwarded to the suite EventBus for unified handling
+- **Event methods on InstrumentContext**: Direct access to `on()`, `once()`, `off()`, and `wait_for()` methods
+
 ### Setting Up Event Handlers
 
 #### Single Instrument Event Handling
@@ -566,11 +574,14 @@ async def event_handling():
         print(f"  New size: {position.size}")
         print(f"  Unrealized P&L: ${position.unrealized_pnl:.2f}")
 
-    # Register event handlers for MNQ
+    # Register event handlers directly on instrument context (v3.5.6+)
     await mnq.on(EventType.NEW_BAR, on_new_bar)
     await mnq.on(EventType.ORDER_FILLED, on_order_filled)
     await mnq.on(EventType.POSITION_CHANGED, on_position_changed)
 
+    # Or use wait_for for specific events (v3.5.6+)
+    new_bar_event = await mnq.wait_for(EventType.NEW_BAR)
+
     # Keep the application running to receive events
     await asyncio.sleep(300)  # Run for 5 minutes
 
@@ -586,7 +597,7 @@ async def multi_instrument_events():
         timeframes=["1min", "5min"]
     )
 
-    # Set up event handlers for each instrument
+    # Option 1: Register handlers on individual instruments
     for symbol, context in suite.items():
         # Create symbol-specific handlers using closures
         def make_handlers(sym):
@@ -603,12 +614,20 @@ async def multi_instrument_events():
 
             return on_new_bar, on_order_filled, on_position_changed
 
-        # Register handlers for this instrument
+        # Register handlers for this instrument (v3.5.6+ direct methods)
         bar_handler, order_handler, position_handler = make_handlers(symbol)
         await context.on(EventType.NEW_BAR, bar_handler)
         await context.on(EventType.ORDER_FILLED, order_handler)
         await context.on(EventType.POSITION_CHANGED, position_handler)
 
+    # Option 2: Register a single handler at suite level for all instruments (v3.5.6+)
+    async def unified_bar_handler(event):
+        # Events from all instruments are forwarded to suite EventBus
+        instrument = event.data.get("instrument", "Unknown")
+        print(f"{instrument} new bar: ${event.data.close:.2f}")
+
+    await suite.on(EventType.NEW_BAR, unified_bar_handler)
+
     print("Monitoring events for all instruments...")
     await asyncio.sleep(300)  # Run for 5 minutes
     await suite.disconnect()