docs: SEO-consistent page titles (fix too-long + too-short <title>)#301
Conversation
Add concise front-loaded titles so every page's rendered <title> lands in the 30-60 char SEO range once the renderer appends ' | Ultralytics', while H1s stay descriptive (distinct from <title>): - Information Security Management System (ISMS) -> 'Information Security (ISMS)' - What to Expect: Security & Compliance ... -> 'Employee Security & Compliance' - Publications -> 'Publications Guidelines' - Introduction -> 'Handbook Introduction' Handbook now audits clean: 0 too-long, 0 too-short, 0 duplicate H1==title. Part of the cross-repo title/H1 unification (portal renderer brand suffix, ultralytics docs).
|
👋 Hello @glenn-jocher, thank you for submitting a
For more guidance, please refer to our Contributing Guide. Don't hesitate to leave a comment if you have any questions. Thank you for contributing to Ultralytics! 🚀 |
UltralyticsAssistant
left a comment
There was a problem hiding this comment.
🔍 PR Review
Made with ❤️ by Ultralytics Actions
Clean PR. The changes are limited to adding explicit frontmatter titles, and the selected titles are consistent with the existing page content and the stated SEO goal. I did not find any actionable issues in the diff.
|
Merged — thank you, @glenn-jocher! 🎉 “Knowledge is of no value unless you put it into practice.” — Anton Chekhov This update is a great example of that principle in action: small metadata improvements like clear page titles make the handbook more navigable, consistent, and useful for everyone. Adding explicit titles to these docs strengthens discoverability and helps readers find the right information faster. Really appreciate the thoughtful polish here — concise, low-risk, and high-impact for documentation quality. |
Summary
Handbook side of the cross-repo effort to fix SEMrush
<title>issues consistently across every Ultralytics doc surface (docs + handbook). Strategy settled via an Opus↔Codex review loop.Unified rule:
<title>={concise, front-loaded title} | Ultralytics(suffix added by the shared docs renderer); the on-page<h1>stays descriptive. They differ only by the suffix → never a duplicate tag; the brand is always present; titles stay in the 30–60 char range.Changes — 4 pages with title issues (H1s unchanged)
title:security/isms.mdInformation Security (ISMS)security/employee-security-compliance-requirements.mdEmployee Security & Compliancecontributions/publications.mdPublications Guidelinesintroduction.mdHandbook IntroductionVerification
Audited all 34 handbook pages with the shared title rule (same predicate the renderer uses): 0 too-long, 0 too-short, 0 duplicate H1==title.
Companion PRs (same unified rule)
🛠️ PR Summary
Made with ❤️ by Ultralytics Actions
🌟 Summary
📝 This PR improves handbook documentation metadata by adding explicit page titles to several English docs pages, making them clearer and better organized.
📊 Key Changes
titlefield to the front matter ofdocs/en/contributions/publications.mdtitlefield to the front matter ofdocs/en/introduction.mdtitlefield to the front matter ofdocs/en/security/employee-security-compliance-requirements.mdtitlefield to the front matter ofdocs/en/security/isms.mdPublications GuidelinesHandbook IntroductionEmployee Security & ComplianceInformation Security (ISMS)🎯 Purpose & Impact