Page MenuHomePhabricator

Review styles of ReadingLists extension under aspect of design system
Closed, ResolvedPublic1 Estimated Story Points

Description

Background

The inherited styling (CSS code) of the ReadingList extension uses numerous opinionated styles. Right now it seems like the CSS styling is done to work in a vacuum, which can be problematic. Specifically forward looking to extending it to mobile.

Goal

Review opinionated styling.
Either it's following the design system (and adhere's to lower level, aka MW and Vector styles) or there's a very good reason for an override.

Excerpt:

.readinglists-container {
	h1 {
		font-family: @font-family-serif; // Doubtful
		font-size: @font-size-x-large; // Doubtful
		font-weight: @font-weight-bold;
		margin: 0; // Doubtful
		padding: 0; // Doubtful
		border-bottom: 0;
	}

	h2 {
		font-family: @font-family-sans; // Doubtful
		font-size: @font-size-medium; // Doubtful
		margin: 0; // Doubtful
		padding: 0; // Doubtful
		border-bottom: 0;
	}

	h3 {
		color: @color-placeholder; // Doubtful
		font-size: @font-size-x-small; // Doubtful
		font-weight: @font-weight-normal; // Doubtful
		margin: 0; // Doubtful
		padding: 0; // Doubtful
	}

	p {
		font-size: @font-size-small; // Doubtful
		margin-top: 0; // Doubtful
		margin-bottom: 1.5em; // Doubtful
		padding-bottom: 0; // Doubtful
	}

	.readinglists-heading {
		display: flex;
		align-items: flex-end;
		gap: 0.5em; // Should be documented
	}

	.readinglists-sort-text {
		font-size: @font-size-small;
		font-weight: @font-weight-normal; // Doubtful if taken out of heading element
		color: @color-placeholder;
		margin-left: 0.5em; // Should be achieved by Codex Design Tokens
	}

Acceptance criteria for done

  • Design reviews the set
  • Engineers remove the unnecessary styles, that are not design intended

Event Timeline

Volker_E raised the priority of this task from High to Needs Triage.Sep 12 2025, 10:40 PM
Volker_E updated the task description. (Show Details)

Change #1188429 had a related patch set uploaded (by VolkerE; author: VolkerE):

[mediawiki/extensions/ReadingLists@master] styles: Remove opinionated styles

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

Change #1188487 had a related patch set uploaded (by VolkerE; author: VolkerE):

[mediawiki/extensions/ReadingLists@master] styles: Use spacing design tokens instead of static values

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

Change #1188429 merged by jenkins-bot:

[mediawiki/extensions/ReadingLists@master] styles: Remove opinionated styles

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

Change #1188487 merged by jenkins-bot:

[mediawiki/extensions/ReadingLists@master] styles: Use spacing design tokens instead of static values

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

We've also updated spacing to be fueled by design tokens. The sorting styles might be reconsidered with new layout in parent task.

Change #1190514 had a related patch set uploaded (by VolkerE; author: VolkerE):

[mediawiki/extensions/ReadingLists@master] styles: Remove skin specific top margin that is not in Design

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

Change #1190514 merged by jenkins-bot:

[mediawiki/extensions/ReadingLists@master] styles: Remove skin specific top margin that is not in design specifications

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