Problem / Why

“Start here” currently mixes onboarding with deep protocol details and doesn’t provide a clean first-time-reader path. New devs struggle to understand what to read first, what’s optional, and how to get to building quickly.

What to do

Redesign the “Start here” page into a small number of clearly-labeled sections, each with a 1–2 sentence explanation aimed at a first-time reader, and a “what to do next” link.

Proposed sections (draft)

1. What is TON
   Short mental model: TON as a scalable, message-driven blockchain for apps.
2. What you can build
   Smart contracts, tokens, mini apps, payments; set expectations.
3. Core concepts you must know (only the basics)
   Accounts/contracts, messages, fees; include high-level defs (workchain, node). No deep dives.
4. Recommended stack (Best practices)Tolk + Blueprint (explicit), plus minimal prerequisites.
5. Your first steps (Hands-on path)
   Install, create project, run tests, deploy to testnet, interact from a script.
6. How to interact with the network (practical)
   Wallets, TON Connect, APIs, explorers — high level only, link out.
7. Next learning paths
   “Smart contracts deeper”, “Tokens”, “TON Connect”, “Run a node” (optional), “Advanced internals” (optional).