Skip to content

Why was the README banner removed? It's a strong visual hook for the project. #80

Description

@torinkwok

Background

The README banner image was removed as part of PR #65 (merged May 14, 2026) without any explicit explanation for the removal. Before that change, the top of the README opened with:

Knowhere banner

<img width="1000" height="233" alt="20260506-102713" src="https://github.com/user-attachments/assets/896e64d2-e50e-4158-b71c-bc69e11c7c65" />

Why this matters

The banner is one of the first things a visitor sees when they land on the repository. It serves a few important purposes:

  • Visual impact. A wide, full-width graphic immediately signals that this is a polished, production-grade project rather than a rough prototype. It grabs attention before the reader has read a single word.
  • Brand identity. The banner carries the Knowhere visual language (typography, colors, style). Without it, the README opens cold with a plain <h1> heading, which is indistinguishable from thousands of other repos.
  • First impression. For developers discovering the project through GitHub search or a shared link, the banner is the primary branding touchpoint. Removing it reduces the perceived quality of the project at a glance.

Question

Was there a specific reason it was removed in PR #65? For example:

  • Was it felt to be redundant with the new architecture diagrams added in the same PR?
  • Is there a plan to replace it with a different banner?
  • Was it removed accidentally as part of a larger README rewrite?

If there's no strong reason to keep it out, I'd suggest restoring it (or replacing it with an updated version). The visual impact it provides is hard to replicate with text and badges alone, and it's an easy win for how the project presents itself to the community.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationquestionFurther information is requested

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions