Skip to content

Give the docs pages descriptive titles - #35

Merged
silveltman merged 1 commit into
mainfrom
seo/titles-descriptions
Oct 19, 2026
Merged

silveltman merged 1 commit into
mainfrom
seo/titles-descriptions

Conversation

@silveltman

@silveltman silveltman commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

The homepage and the docs pages had one-word titles such as "Sitex", "Pages" and "Rendering", all under 15 characters, which say little in search results. Each title now says what the page covers. On the docs pages the title is also the page heading; the sidebar and the previous and next links keep their short labels. The installation description was 41 characters and now says what the page covers.

Titles:

Page Old New
/ Sitex (5) Sitex: React Framework for Static Content Sites (47)
/docs Introduction (12) Introduction to Sitex (21)
/docs/installation Installation (12) Install Sitex and Create Your First Page (40)
/docs/pages Pages (5) MDX Pages and Frontmatter (25)
/docs/layouts Layouts (7) TSX Layouts and Globals (23)
/docs/rendering Rendering (9) Static Rendering and Islands (28)

Descriptions:

Page Old New
/docs/installation Install Sitex and create your first page. (41) Add Sitex to a Vite+ project, set up the TypeScript config and folders, and build the site to static HTML. (106)

The other descriptions already pass and stay as they are. All 6 pages of the build now meet Scan's new rules: titles of 15 to 60 characters, descriptions of 50 to 160, none missing or duplicated. llms.txt lists the docs under their new titles. An empty changeset covers this docs-only change.

vp run check, vp run build and changeset status pass. On the deploy preview, the 6 pages in the sitemap pass the same rules and load without console errors in Chromium, Firefox and WebKit at desktop and phone width; the longer headings wrap cleanly on a phone.

🤖 Generated with Claude Code

The homepage and the docs pages had one-word titles such as "Sitex",
"Pages" and "Rendering", which say little in search results. Each now says
what the page covers, such as "MDX Pages and Frontmatter" and "Static
Rendering and Islands"; the title is also the page heading, and the sidebar
keeps its short labels. The installation page gets a description that says
what it covers. Every page now has a title of 15 to 60 characters and a
description of 50 to 160.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@netlify

netlify Bot commented Oct 19, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for fulldev-sitex ready!

Name Link
🔨 Latest commit fa1ef10
🔍 Latest deploy log https://app.netlify.com/projects/fulldev-sitex/deploys/6ad5f23c34bcab07ca418e56
😎 Deploy Preview https://deploy-preview-35--fulldev-sitex.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@silveltman
silveltman marked this pull request as ready for review October 19, 2026 10:39
@silveltman
silveltman merged commit 5c3fd55 into main Oct 19, 2026
11 checks passed
@silveltman
silveltman deleted the seo/titles-descriptions branch October 19, 2026 10:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant