Skip to content

docs: add audience-differentiated entry paths to Block Node home page #1000

Description

@deshmukhpranali

The current Block Node home page presents three cards that jump into technical sections without role context. Readers — especially developers and product stakeholders — cannot tell which path applies to them.

Change needed: Add a "Start here" section with three entry paths:

  • Developer (integrate & build) — 3-step reading journey
  • Operator (deploy & run) — 3-step reading journey
  • Learn (understand the architecture) — 3-step reading journey

Acceptance criteria:

  • New or updated cards on the Block Node landing page covering all three personas
  • Each path gives a concise suggested reading order
  • No existing content removed — additive only

Source: External doc audit (August 2026) — community onboarding rated 3/10.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationenhancementNew feature or requestp1Highest priority

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions