wrappers
Open, HighPublic
Actions

Description

In response to T416431: Section wrapping not working on page on pages with unbalanced templates and T414734: MobileFrontend + Parsoid has different collapsible-section HTML on en.wp main page, we will update our section wrapping spec in https://www.mediawiki.org/wiki/Parsing/Notes/Section_Wrapping and attempt to suppress <section> wrapping around "HTML tag" headings, so that <section> only wraps == ... == wikitext constructs.

Details

Related Changes in Gerrit:

Subject	Repo	Branch	Lines +/-
Bump wikimedia/parsoid to 0.23.0-a24	mediawiki/vendor	master	+213 -111
[OTP] Continue to mark html headings with a class	mediawiki/core	master	+45 -52
Html headings aren't section wrapped	mediawiki/services/parsoid	master	+66 -11

Customize query in gerrit

Related Objects

Mentioned In: T421859: frwiki rendering difference with Parsoid
T417531: Section wrapping should use precise information about HTML-syntax headings
Mentioned Here: T417531: Section wrapping should use precise information about HTML-syntax headings
T414734: MobileFrontend + Parsoid has different collapsible-section HTML on en.wp main page
T416431: Section wrapping not working on page on pages with unbalanced templates

Event Timeline

cscott created this task.Feb 16 2026, 5:44 AM

Restricted Application added a subscriber: Aklapper. · View Herald TranscriptFeb 16 2026, 5:44 AM

Izno subscribed.Feb 16 2026, 5:46 AM

cscott mentioned this in T417531: Section wrapping should use precise information about HTML-syntax headings.Feb 16 2026, 5:48 AM

cscott updated the task description. (Show Details)

MSantos moved this task from Needs Triage to Missing Functionality on the Parsoid board.Feb 19 2026, 3:23 PM

ABreault-WMF claimed this task.Feb 19 2026, 3:23 PM

ABreault-WMF moved this task from Backlog to Q3 FY25-26 on the Content-Transform-Team (Work In Progress) board.Feb 19 2026, 9:34 PM

Change #1244822 had a related patch set uploaded (by Arlolra; author: Arlolra):

[mediawiki/services/parsoid@master] [WIP] Meh

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

gerritbot added a project: Patch-For-Review.Feb 26 2026, 8:22 PM

MSantos triaged this task as High priority.Mar 5 2026, 3:22 PM

Jdlrobson-WMF subscribed.Mar 11 2026, 6:09 PM

ABreault-WMF moved this task from Q3 FY25-26 to In Progress on the Content-Transform-Team (Work In Progress) board.Mar 12 2026, 8:30 PM

Jdlrobson-WMF moved this task from Backlog to Blockers on the Readers Essential Work (WE6.3.4 Fix bugs within the reading experience across platforms for Parsoid Read Views) board.Mar 13 2026, 10:10 PM

Change #1260830 had a related patch set uploaded (by Arlolra; author: Arlolra):

[mediawiki/core@master] [OTP] Continue to mark html headings with a class

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

ABreault-WMF moved this task from In Progress to Code Review on the Content-Transform-Team (Work In Progress) board.Thu, Mar 26, 6:08 PM

Change #1260830 merged by jenkins-bot:

[mediawiki/core@master] [OTP] Continue to mark html headings with a class

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

ReleaseTaggerBot added a project: MW-1.46-notes (1.46.0-wmf.22; 2026-03-31).Thu, Mar 26, 7:00 PM

Change #1244822 merged by jenkins-bot:

[mediawiki/services/parsoid@master] Html headings aren't section wrapped

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

ABreault-WMF moved this task from Code Review to To Deploy on the Content-Transform-Team (Work In Progress) board.Thu, Mar 26, 7:04 PM

Maintenance_bot removed a project: Patch-For-Review.Thu, Mar 26, 7:31 PM

I think this might need a small follow up for h1s.

Here's some test cases where parsoid differs from legacy:
https://en.wikipedia.beta.wmcloud.org/wiki/T414734-2?useparsoid=1 vs
https://en.wikipedia.beta.wmcloud.org/wiki/T414734-2?useparsoid=0
https://en.wikipedia.beta.wmcloud.org/wiki/T414734?useparsoid=1 vs
https://en.wikipedia.beta.wmcloud.org/wiki/T414734?useparsoid=0

Change #1264672 had a related patch set uploaded (by Isabelle Hurbain-Palatin; author: Isabelle Hurbain-Palatin):

[mediawiki/vendor@master] Bump wikimedia/parsoid to 0.23.0-a24

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

gerritbot added a project: Patch-For-Review.Mon, Mar 30, 4:08 PM

Change #1264672 merged by jenkins-bot:

[mediawiki/vendor@master] Bump wikimedia/parsoid to 0.23.0-a24

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

Maintenance_bot removed a project: Patch-For-Review.Mon, Mar 30, 6:31 PM

ABreault-WMF moved this task from To Deploy to To Verify on the Content-Transform-Team (Work In Progress) board.Thu, Apr 2, 3:38 PM

ABreault-WMF mentioned this in T421859: frwiki rendering difference with Parsoid.Thu, Apr 2, 9:15 PM

In T417530#11760151, @Jdlrobson-WMF wrote:

I think this might need a small follow up for h1s.

We said this elsewhere but just so that it's recorded here too, the current definition of an html heading requires that it be given attributes in the source. That's from the limitation described in T417531

Ultimately, we'd like to say that if you're using html syntax for headings, regardless of attributes, then they don't get section wrapping, section edit links, aren't included in the TOC. The patch we deployed is a first step to see how feasible that is

ABreault-WMF moved this task from To Verify to In Progress on the Content-Transform-Team (Work In Progress) board.Thu, Apr 2, 10:04 PM

This has been documented here: https://www.mediawiki.org/wiki/Parsoid/Parser_Unification/Instructions_for_editors#Heading_parsing_differences

Jdlrobson-WMF moved this task from WE6.3.4 Fix bugs within the reading experience across platforms for Parsoid Read Views to Tracking on the Readers Essential Work board.Wed, Apr 8, 8:58 PM

Jdlrobson-WMF edited projects, added Readers Essential Work; removed Readers Essential Work (WE6.3.4 Fix bugs within the reading experience across platforms for Parsoid Read Views).

Jdlrobson-WMF moved this task from Tracking to WE6.3.4 Fix bugs within the reading experience across platforms for Parsoid Read Views on the Readers Essential Work board.

Jdlrobson-WMF edited projects, added Readers Essential Work (WE6.3.4 Fix bugs within the reading experience across platforms for Parsoid Read Views); removed Readers Essential Work.