git: 15e37adf47 - main - Fix HTML validation errors in docs - articles title section

The branch main has been updated by vladlen:

URL: https://cgit.FreeBSD.org/doc/commit/?id=15e37adf477305e785de546ac893b6ed52de4f20

commit 15e37adf477305e785de546ac893b6ed52de4f20
Author:     Vladlen Popolitov <vladlen@FreeBSD.org>
AuthorDate: 2026-09-27 12:55:44 +0000
Commit:     Vladlen Popolitov <vladlen@FreeBSD.org>
CommitDate: 2026-09-27 12:55:44 +0000

    Fix HTML validation errors in docs - articles title section
    
    article: render subtitle as <p> instead of <h3>
    
    The subtitle is part of the title block, not a section heading.
    Rendering it as <h3> right after <h1> broke W3C validation and
    caused screen readers to announce it as a level-3 heading.
    
    Move the visual styling from the <h3> tag to a `.subtitle` class
    in documentation.scss to keep the appearance unchanged.
    
    Reviewed by: carlavilla
    Approved by: carlavilla
    Differential Revision: https://reviews.freebsd.org/D60058
    PR: 297509
---
 documentation/themes/beastie/assets/styles/documentation.scss | 8 ++++++++
 documentation/themes/beastie/layouts/articles/list.html       | 2 +-
 documentation/themes/beastie/layouts/articles/single.html     | 2 +-
 3 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/documentation/themes/beastie/assets/styles/documentation.scss b/documentation/themes/beastie/assets/styles/documentation.scss
index 3b49bc26da..57268458e4 100644
--- a/documentation/themes/beastie/assets/styles/documentation.scss
+++ b/documentation/themes/beastie/assets/styles/documentation.scss
@@ -68,6 +68,14 @@
     h1 {
       margin: .8rem 0;
     }
+
+    .subtitle {
+      font-size: var(--size-550);
+      font-weight: bold;
+      color: var(--global-font-color);
+      margin-top: 1.5rem;
+      margin-bottom: 1.3rem;
+    }
   }
 }
 
diff --git a/documentation/themes/beastie/layouts/articles/list.html b/documentation/themes/beastie/layouts/articles/list.html
index 7c9cddd7d9..581316abd9 100644
--- a/documentation/themes/beastie/layouts/articles/list.html
+++ b/documentation/themes/beastie/layouts/articles/list.html
@@ -12,7 +12,7 @@
       </div>
     {{ end }}
     {{ if .Params.subtitle }}
-      <h3 class="subtitle">{{ .Params.subtitle }}</h3>
+      <p class="subtitle">{{ .Params.subtitle }}</p>
     {{ end }}
     {{ if .Params.copyright }}
       <div class="copyright">
diff --git a/documentation/themes/beastie/layouts/articles/single.html b/documentation/themes/beastie/layouts/articles/single.html
index 88ebbe4443..3b08e1bb49 100644
--- a/documentation/themes/beastie/layouts/articles/single.html
+++ b/documentation/themes/beastie/layouts/articles/single.html
@@ -12,7 +12,7 @@
       </div>
     {{ end }}
     {{ if .Params.subtitle }}
-      <h3 class="subtitle">{{ .Params.subtitle }}</h3>
+      <p class="subtitle">{{ .Params.subtitle }}</p>
     {{ end }}
     {{ if .Params.copyright }}
       <div class="copyright">