Skip to content

[Start here > Overview] Remove ADNL/TCP/liteserver deep dive that confuses beginners #1681

@delovoyhomie

Description

@delovoyhomie

Problem / Why

In Start here, the explanation of ADNL, TCP limitations, and liteserver jumps to an advanced networking level too early. Readers report getting lost at this point, which breaks the onboarding flow and reduces overall comprehension and confidence.

What to do

  • Delete (from Start here) the advanced ADNL/TCP/liteserver explanation that’s not needed for initial understanding.
  • Keep only a one-liner if necessary (optional): “Apps typically use an API provider / lite-server gateway; deeper networking details are covered later.”
  • If the content is valuable, move it to an advanced section (e.g., Blockchain foundations > Networking or Advanced > ADNL/Lite servers) and link to it from Start here as “Advanced reading.”

Acceptance criteria

  • The Start here page no longer contains detailed ADNL/TCP/liteserver internals.
  • The onboarding narrative stays beginner-friendly and doesn’t introduce low-level networking concepts without need.
  • If moved, the advanced page clearly explains ADNL/liteserver with context and prerequisites, and Start here links to it as optional.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions