Skip to content

docs: fix boot-order claim for subscription wiring#524

Open
lgahdl wants to merge 1 commit into
developfrom
docs/341-boot-order-fix
Open

docs: fix boot-order claim for subscription wiring#524
lgahdl wants to merge 1 commit into
developfrom
docs/341-boot-order-fix

Conversation

@lgahdl

@lgahdl lgahdl commented Jul 21, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Doc 02 claimed the runtime "wires up event sources before calling init" for a module's subscriptions.
  • builder.rs's launch() actually boots modules (Supervisor::boot_single/boot, which run each module's init) before event_loop::open_block_streams/open_chain_log_streams subscribes to anything - the opposite order.
  • Corrected the sentence to state the real order: subscriptions are wired up once every module has loaded and initialised.

Closes #341

Doc 02 said the runtime wires up event sources before calling a
module's init, but builder.rs boots modules (running init) before
event_loop::open_block_streams/open_chain_log_streams subscribes to
anything - the opposite order. Correct the claim to match the actual
boot sequence.

Closes #341
@lgahdl
lgahdl requested a review from mfw78 as a code owner July 21, 2026 19:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: doc 02 says subscriptions wire up before init - actual boot order is the opposite

1 participant