# HTML5 outline validity on CI

**URL:** <https://forum.xwiki.org/t/html5-outline-validity-on-ci/18084>\
**Category:** Development\
**Tags:** xwiki\
**Created:** [January 6, 2026, 10:29am UTC](https://forum.xwiki.org/t/html5-outline-validity-on-ci/18084 "2026-01-06T10:29:22Z")\
**Posts on this page:** 8\
**Page:** 1

<div class="post-metadata">

**Author:** ![CharpentierLucas](https://forum.xwiki.org/user_avatar/forum.xwiki.org/charpentierlucas/32/4830_2.png) [@CharpentierLucas](https://forum.xwiki.org/u/CharpentierLucas)\
**Post date:** [January 6, 2026, 10:29am UTC](https://forum.xwiki.org/t/html5-outline-validity-on-ci/18084/1 "2026-01-06T10:29:22Z")

</div>

Hi!

## Context

A few days ago, a lot of HTML5 validation errors have shown up in CI, such as:  
[https://ci.xwiki.org/job/XWiki/job/xwiki-platform/job/master/8346/testReport/junit/org.xwiki.test.webstandards.framework/DefaultValidationTest/Platform\_Builds\_\_\_main\_\_\_distribution\_\_\_flavor\_test\_webstandards\_\_\_Build\_for\_Flavor\_Test\_\_\_Webstandards\_\_\_Validating\_HTML5\_validity\_for\_\_http\_\_\_127\_0\_0\_1\_8080\_xwiki\_bin\_view\_XWiki\_XWikiSyntaxHeadings\_\_executed\_with\_credentials\_Admin\_admin\_2/](https://ci.xwiki.org/job/XWiki/job/xwiki-platform/job/master/8346/testReport/junit/org.xwiki.test.webstandards.framework/DefaultValidationTest/Platform_Builds ___main___ distribution ___flavor_test_webstandards___ Build_for_Flavor_Test ___Webstandards___ Validating_HTML5_validity_for __http___ 127_0_0_1_8080_xwiki_bin_view_XWiki_XWikiSyntaxHeadings__executed_with_credentials_Admin_admin_2/)

This happened because of an update to the nu validator:

- [feat: Add heading-hierarchy checker (for reporting “skipped” levels) · validator/validator@3b8db6d · GitHub](https://github.com/validator/validator/commit/3b8db6df21f75ddbbda8f75a3384205dd28bbcd5)
- [Requirements of HTML specification regarding hierarchy of headings is not validated · Issue #1441 · validator/validator · GitHub](https://github.com/validator/validator/issues/1441)

implementing the sentence

> Each [heading](https://html.spec.whatwg.org/multipage/sections.html#concept-heading) following another [heading](https://html.spec.whatwg.org/multipage/sections.html#concept-heading) lead in the [outline](https://html.spec.whatwg.org/multipage/sections.html#outline) must have a [heading level](https://html.spec.whatwg.org/multipage/sections.html#heading-level) that is less than, equal to, or 1 greater than lead’s [heading level](https://html.spec.whatwg.org/multipage/sections.html#heading-level).

from the [HTML Standard](https://html.spec.whatwg.org/multipage/sections.html#outline)

I agree that it’s an important part of the standard and we should not overlook it.  
However most of those errors have probably been in XWiki for years, and we got little user feedback about it.

## Proposed solution

I don’t think it becomes a high priority because of the reduced impact it has on the end users.  
IMO we can report those as bugs and toggle the validation for them OFF for now (by filtering errors by message content). Then once all the bugs have been fixed, we toggle the validation back ON.  
This way we can take note of where to improve our HTML compliance without cluttering the CI results with lower priority bugs (usually things that are caught on CI are regressions or critical 🙂 ).

* * *

What do you think of this solution?

Thanks!  
Lucas C.

---

<div class="post-metadata">

**Author:** ![CharpentierLucas](https://forum.xwiki.org/user_avatar/forum.xwiki.org/charpentierlucas/32/4830_2.png) [@CharpentierLucas](https://forum.xwiki.org/u/CharpentierLucas)\
**Post date:** [January 6, 2026, 10:30am UTC](https://forum.xwiki.org/t/html5-outline-validity-on-ci/18084/2 "2026-01-06T10:30:37Z")

</div>

I’ll start moving on with this solution right now, this discussion is also here to keep track of our decision process on this.

---

<div class="post-metadata">

**Author:** ![surli](https://forum.xwiki.org/user_avatar/forum.xwiki.org/surli/32/2687_2.png) [@surli](https://forum.xwiki.org/u/surli)\
**Post date:** [January 6, 2026, 10:39am UTC](https://forum.xwiki.org/t/html5-outline-validity-on-ci/18084/3 "2026-01-06T10:39:00Z")

</div>

> [@CharpentierLucas](#):
>
> I don’t think it becomes a high priority because of the reduced impact it has on the end users.  
> IMO we can report those as bugs and toggle the validation for them OFF for now (by filtering errors by message content). Then once all the bugs have been fixed, we toggle the validation back ON.  
> This way we can take note of where to improve our HTML compliance without cluttering the CI results with lower priority bugs (usually things that are caught on CI are regressions or critical 🙂 ).

+1

---

<div class="post-metadata">

**Author:** ![tmortagne](https://forum.xwiki.org/user_avatar/forum.xwiki.org/tmortagne/32/4930_2.png) [@tmortagne](https://forum.xwiki.org/u/tmortagne)\
**Post date:** [January 6, 2026, 11:00am UTC](https://forum.xwiki.org/t/html5-outline-validity-on-ci/18084/4 "2026-01-06T11:00:12Z")

</div>

+1

---

<div class="post-metadata">

**Author:** ![vmassol](https://forum.xwiki.org/user_avatar/forum.xwiki.org/vmassol/32/6_2.png) [@vmassol](https://forum.xwiki.org/u/vmassol)\
**Post date:** [January 6, 2026, 12:01pm UTC](https://forum.xwiki.org/t/html5-outline-validity-on-ci/18084/5 "2026-01-06T12:01:26Z")

</div>

+1 thx

---

<div class="post-metadata">

**Author:** ![mleduc](https://forum.xwiki.org/user_avatar/forum.xwiki.org/mleduc/32/2328_2.png) [@mleduc](https://forum.xwiki.org/u/mleduc)\
**Post date:** [January 6, 2026, 12:22pm UTC](https://forum.xwiki.org/t/html5-outline-validity-on-ci/18084/6 "2026-01-06T12:22:57Z")

</div>

+1 thanks

---

<div class="post-metadata">

**Author:** ![Simpel](https://forum.xwiki.org/user_avatar/forum.xwiki.org/simpel/32/3655_2.png) [@Simpel](https://forum.xwiki.org/u/Simpel)\
**Post date:** [January 12, 2026, 5:36pm UTC](https://forum.xwiki.org/t/html5-outline-validity-on-ci/18084/7 "2026-01-12T17:36:44Z")

</div>

A `<h3>` following a `<h1>` is an accessibility issue. You won’t succeed a bitv test (it’s like wcag in germany) with this issue.

This is the reason why our selfmade toc panel definitely will show ugly empty list item dots on missing headings in the hierarchy. This way it shows there is something wrong.

---

<div class="post-metadata">

**Author:** ![CharpentierLucas](https://forum.xwiki.org/user_avatar/forum.xwiki.org/charpentierlucas/32/4830_2.png) [@CharpentierLucas](https://forum.xwiki.org/u/CharpentierLucas)\
**Post date:** [November 17, 2026, 4:00pm UTC](https://forum.xwiki.org/t/html5-outline-validity-on-ci/18084/8 "2026-11-17T16:00:34Z")

</div>

The validation has been turned off, then the issues have been addressed:

- XWIKI-23867 (captcha preferences)
- XWIKI-23869 (image style code page)
- XWIKI-23870 (tourCode/stepSheet)
- XWIKI-23871 (entityNameValidation, closed as “Solved By”)
- XWIKI-23872 (XWikiSyntaxHeadings)

All that’s left is [Loading...](https://jira.xwiki.org/browse/XWIKI-23868) , moving forward and closing this topic as it’s been agreed and mostly fixed by now.
