Skip to content

docs: surface Awesome Works above the fold (it sits at 85% depth, below the FAQ) - #289

Merged
Perry2004 merged 1 commit into
mainfrom
docs/awesome-works-placement
Aug 19, 2026
Merged

docs: surface Awesome Works above the fold (it sits at 85% depth, below the FAQ)#289
Perry2004 merged 1 commit into
mainfrom
docs/awesome-works-placement

Conversation

@reacher-z

Copy link
Copy Markdown
Collaborator

Answers a maintainer question — does moving Awesome Works up help publicity? — with a measurement, then acts on it.

The measurement (on current main)

Awesome Works sits at line 981 of 1,151 — 85% of the way down, below both FAQ blocks. A reader reaches it only after ~40 screens of scrolling, and the FAQ ahead of it is a classic exit point: people who open a FAQ are usually after one answer and then leave.

That is the wrong place for the strongest piece of social proof the project owns — 17 works from Google DeepMind, Stanford, UC Berkeley, Microsoft Research, Harvard, ETH Zürich, Oxford, Northwestern, ByteDance Seed and HKUST, plus an industry model report (Li Auto's Mach-Mind-4-Flash) that evaluates on ClawBench. For a benchmark, who already builds on this is the credibility argument that decides whether a new reader adopts it. Buried below the FAQ, most readers never see it.

The change

  • Awesome Works → line 199, right after News. It now sits in the same reading zone as Datasets and Results, where a reader deciding whether to adopt ClawBench is still on the page.
  • The institution line becomes the lede, in bold, and names the Li Auto report — one sentence a skimmer absorbs without reading a single entry.
  • 8 entries visible, 9 behind a <details> fold — the section costs little vertical space up top. All 17 entries preserved; the #awesome-works-using-clawbench anchor is unchanged, so existing links still work.
  • License badge moves into the existing curated-lists fold, leaving only signal badges in the visible row (maintainer request).
  • zh-CN contact now reads "Yuxuan Zhang" without the CJK name (maintainer request).

Notes for review

…e, drop CJK name from zh contact

- Awesome Works moves from line 823 (80% down, right after the FAQ) to line
  438, immediately after News: readers no longer scroll past the FAQ — a
  natural exit point — to reach the strongest social proof the project has.
  The institution line becomes a bold lede naming Li Auto's Mach-Mind-4-Flash
  report; 8 entries stay visible with the other 9 behind a fold, so the
  section costs little vertical space. Anchor and all 17 entries preserved.
- License badge moves into the existing 'More badges' fold.
- zh-CN contact lists the maintainer as 'Yuxuan Zhang' (no CJK name).
@reacher-z

Copy link
Copy Markdown
Collaborator Author

Rebased onto main now that #283 has landed — the measurement holds on the new README: Awesome Works sits at line 823 of 1,033 (80% down), immediately after the FAQ. This PR moves it to line 438, right after News. All 17 entries and the anchor are preserved; 8 visible + 9 folded. <details> balanced 29/29.

@reacher-z
reacher-z force-pushed the docs/awesome-works-placement branch from 03fd7e8 to 48081c6 Compare August 18, 2026 11:00
@Perry2004 Perry2004 added the documentation Improvements or additions to documentation label Aug 19, 2026
@Perry2004
Perry2004 merged commit 6e04c20 into main Aug 19, 2026
1 check passed
@Perry2004
Perry2004 deleted the docs/awesome-works-placement branch August 19, 2026 03:48
@github-project-automation github-project-automation Bot moved this from Todo to Done in ClawBench Aug 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants