seo: shorten 239 page titles to under 60 characters#73
Merged
Conversation
Ahrefs flagged 'Title too long' on pages whose <title> exceeded 60 chars even after the theme-suffix drop (PR #69), because the title itself was long. Set/normalize the frontmatter title on each affected page so the <title> tag (and nav label) fits, WITHOUT touching the visible H1 heading (which comes from the markdown, not frontmatter). Applied consistent, keyword- preserving rules: drop the ' | CorpusIQ ...' brand tail and marketing sub-clauses, drop 'Setup Guide:' / 'Integration Guide:' boilerplate and '(NNN Installs)' counts, collapse 'Full Setup Guide for Hermes Agents' and 'for AI Agents' suffixes, and trim changelog item lists. 17 titles that the rules left long were hand-shortened. Also collapses a pre-existing duplicate 'title:' frontmatter key on 23 of these pages (YAML kept the last, so the shorter first key was dead). Verified with a local build: 0 pages emit a <title> over 60 chars (was 239), every visible H1 is unchanged, and the frontmatter gate passes. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013AQVwDoBsVJHHgZLv1EEKJ
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Shortens 239 doc page titles to under 60 chars per the SEO title-length rule (240 files, frontmatter-only edits).
Note: the original branch
claude/docs-shorten-long-titlesis blocked by a GitHub ghost-PR record (a half-created PR — the phantom '#70' Ben saw — that renders nowhere but blocks new PRs on that head). Re-pointed to a fresh branch to get a clean PR. Same commit (47cac6c). Powered by CorpusIQ