Page MenuHomePhabricator

Find appropriate name for "beginning" section of ToC
Closed, ResolvedPublic

Description

Background

On MediaWiki.org as well as the enwiki Village Pump, we have discussed the opportunity to create more accurate naming for the lead/beginning section of a page that works across wikis, projects, and namespaces. This is task aims to center the conversation and focus on evaluating existing proposals for a more appropriate name

Acceptance criteria

  • Evaluate options for naming of the first section in the ToC and select best cross-wiki name suggestion

Event Timeline

ovasileva triaged this task as Medium priority.Aug 9 2022, 2:27 PM

I'd like to see this ticket (or another related one) include an exploration of design options, not just name options. I'm not sure you'll ever find a word that's completely unambiguous, but there are lots of other ways to set it off to make it clear it's not a section. Brainstorming some of those:

  • Bolding it
  • Surrounding it with parentheses or brackets, as done currently on en.WP thanks to @Xaosflux
  • Adding or turning it into a carat (^)
  • Moving it to the top right corner of the ToC box, across from the word "Contents"
  • Making clicking on "Contents" itself be the thing that takes you to the top

My personal solution is to replace it with just 🠕.
I chose to use a non-text replacement, because that is less distracting for me. (If I see text, I read it!).
I tried other unicode arrows, and simply preferred the aesthetics of that one, when shown at the currently specified type size.

As that one looks like OF85 unicode font fail to me, no thanks! An option we were just discussing on-wiki was possibly to include a (horizontal line) under the label; tried to mock that up with styling, but the vector-2022 TOC doesn't render spans.

Personally I like the proposal here to just use the page title. Unlike “Introduction” or “Beginning” it won’t conflict with other section titles. It also probably won’t require special handling from a design perspective, as it’s just another heading and is consistent with all the other links in the TOC

@ovasileva just posted a response on village pump (link to response) which includes this prototype: https://di-toc-first-link.web.app/Moss
moving to Blocked on others until we hear back from people

Resolving based on the outcome of the current conversation