Page MenuHomeFreeBSD

doc: fix HTML validation errors
ClosedPublic

Authored by vladlen on Sat, Sep 26, 9:56 AM.
Tags
Referenced Files
F173517143: D60037.diff
Sat, Sep 26, 12:59 PM
F173510853: D60037.id187729.diff
Sat, Sep 26, 11:45 AM
F173510614: D60037.id187731.diff
Sat, Sep 26, 11:43 AM
F173507722: D60037.diff
Sat, Sep 26, 11:14 AM
F173504424: D60037.id187729.diff
Sat, Sep 26, 10:35 AM
F173503718: D60037.diff
Sat, Sep 26, 10:27 AM
Subscribers
None

Details

Summary

All documentation pages failed HTML validation due to a duplicate
id="TableOfContents" (side + mobile TOC) and an invalid heading level
(h1 → h3 skip in both TOC labels and in the Resources block).

Fix:

  • Replaced the <h3> labels with <p class="toc-title">/<p class="resources-title">, as already done for the footer, to remove the heading-level skip.
  • Renamed the mobile TOC id to "TableOfContentsMobile" to eliminate the duplicate id.
  • Updated CSS: new .toc-title/.resources-title rules use var(--size-550), bold weight, line-height 1.3 and matching paddings, so the labels keep the exact look of the previous <h3>.

Checked locally: both TOCs render as before and the pages now pass
W3C validation in this code (still they have other validation errors).

Diff Detail

Repository
R9 FreeBSD doc repository
Lint
Lint Not Applicable
Unit
Tests Not Applicable

Event Timeline

vladlen created this revision.

Thank you so much for taking care of this

documentation/themes/beastie/assets/styles/documentation.scss
304

indentation, can be fixed on the commit

This revision is now accepted and ready to land.Sat, Sep 26, 9:57 AM
This revision was automatically updated to reflect the committed changes.