[Start here > Your first smart contract] Add a tiny diagram explaining message flow (wallet → external → contract → internal → result) #1687
Description
Problem / Why
New developers often don’t understand how TON execution is triggered and why interactions look like “messages,” especially the difference between what the wallet sends and what the contract emits afterward. A small diagram will reduce confusion and help readers reason about transactions and results.
What to do
Add a compact diagram (and 2–3 lines of explanation) to the tutorial showing the standard interaction flow:
Wallet (smart contract) → sends external message → contract executes → internal messages emitted → observable result (state change / reply / event-like notification / bounce)
Diagram requirements
- Interactive diagram?? Or just Mermaid, for starters.
- Keep it tiny (fits in the tutorial without breaking reading flow)
- Explicitly label external message vs internal messages
- Links (optional) to deeper “Messages / Transactions” docs for advanced reading.