Skip to content

README: lead with what the catalog is; fresh light and dark hero; development moved down - #39

Merged
raelsei merged 1 commit into
mainfrom
agent/readme
Nov 9, 2026
Merged

raelsei merged 1 commit into
mainfrom
agent/readme

Conversation

@raelsei

@raelsei raelsei commented Nov 9, 2026

Copy link
Copy Markdown
Member

Change

The README read like a contributor guide from the second screen on; visitors from the launch saw a file tree and bun install before what the catalog is. New order (Koray, 2026-11-09):

  1. Centered app icon, name, one line on what it is, and three links: the catalog, How We Verify, Add an app.
  2. A fresh hero of the live Discover page, light and dark (<picture> follows the reader's GitHub theme), linked to the site. docs/preview.webp and docs/preview-dark.webp replace docs/preview.png, which still showed 1,887 apps and letter tiles where icons now are.
  3. What you get: the license from the file (the NOASSERTION example), the Source available label, official downloads only, the Unmaintained label.
  4. The generated category table (unchanged block).
  5. Add or fix an app: the two issue forms and CONTRIBUTING.
  6. How it works and Development, shorter, at the bottom.
  7. Credits and licensing.

Dropped: "A considered collection" (a praise word the house style bans). No hand-written app counts outside the generated block, so nothing goes stale. docs/PUBLISHING.md describes how the hero is captured.

Verification

bun run sync (README block unchanged), bun run check:generated, bun run validate, bun test, bun run build, bun run check:links. Viewed the branch on GitHub in light and dark: icon and both hero images load, and the dark image swaps in.

Undo

Revert this commit.

@raelsei
raelsei merged commit 2717501 into main Nov 9, 2026
1 check passed
@raelsei
raelsei deleted the agent/readme branch November 9, 2026 01:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant