Page MenuHomePhabricator

[Minerva TOC] Make entire header clickable
Closed, ResolvedPublic2 Estimated Story Points

Description

Initial usability study results indicated poor discovery of the TOC from the header button.

Matthias's theory is as follows:

I think the main issue with the sticky header discoverability right now is that it doesn’t look like an interactive element. It blends in (too) well with the rest of the page, and while it has a “button” to open the TOC, it is not obvious that it is an interactive element and can easily be mistaken for being nothing more than illustrative.

And we can improve that through:

  • making it so that that whole header area can be clicked to toggle the TOC
  • setting it apart more from the content (full-length border with some shadow for depth perception), making it slightly more obvious that it’s potentially <more than purely visual>
  • adding the border around that icon, making it more obvious that it’s a button that can be clicked

Design update from Justin:

If we use a neutral-normal button for the ToC and add a box-shadow-large effect in addition to a muted border beneath the header, it's way more visible.

Screenshot 2026-02-11 at 9.13.31 AM (1).png (1,324×748 px, 150 KB)

Here's an existing patch over which we discussed these changes; it does most of the work already, but needs (at least) some styling changes: https://gerrit.wikimedia.org/r/c/mediawiki/extensions/ReaderExperiments/+/1238301

Slack thread here

Acceptance criteria

  • The TOC button/icon has a frame
  • The whole header is clickable
    • Ensure that this doesn't break the TOC button (i.e. doesn't record 2 actions when clicking there)
    • Ensure that this doesn't break the edit button (i.e. clicking that spot of the header should still bring you to edit, not open TOC)
  • Sticky header looks exactly like attached design, with a full-length border/shadow

Related Objects

StatusSubtypeAssignedTask
ResolvedNone
Resolvedmatthiasmullie

Event Timeline

HSwan-WMF moved this task from Incoming/Inbox to Backlog on the Reader Growth Team board.
HSwan-WMF moved this task from Backlog to Needs Refinement on the Reader Growth Team board.
HSwan-WMF set the point value for this task to 2.Feb 11 2026, 5:30 PM

Change #1238301 had a related patch set uploaded (by Matthias Mullie; author: Matthias Mullie):

[mediawiki/extensions/ReaderExperiments@master] Make entire header clickable

https://gerrit.wikimedia.org/r/1238301

Change #1238301 merged by jenkins-bot:

[mediawiki/extensions/ReaderExperiments@master] Make entire header clickable

https://gerrit.wikimedia.org/r/1238301

Etonkovidova subscribed.
  • The TOC button/icon has a frame
  • Sticky header looks exactly like attached design, with a full-length border/shadow

Checked on enwiki beta (e.g. https://en.wikipedia.beta.wmcloud.org/wiki/Cats?mpo=minerva-toc-sticky:treatment) - the screenshots below illustrate two states of the toc button:

Screenshot 2026-02-13 at 5.25.24 PM.png (373×244 px, 49 KB)
Screenshot 2026-02-13 at 5.25.41 PM.png (371×562 px, 43 KB)