Skip to content

Restructure README front-matter for cold-visitor comprehension #33

@adiled

Description

@adiled

The current README assumes the reader already knows the problem. First-time visitors who don't already feel the pain bounce.

Target order

  1. One-line pitch
  2. Demo gif (already exists in repo as clwnd.gif)
  3. "What this solves" paragraph (the new addition)
  4. Install snippet
  5. Quick example
  6. Existing config table and remainder

Action

  • Add the "what this solves" paragraph above the install snippet.
  • Move the demo gif above the install snippet if not already there.
  • Verify the cold-visitor flow: can someone who has never heard of clwnd understand within 60 seconds?

Context
Tracked in the distribution playbook at adiled/distribution.

~ distribution team

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions