docs(factories): lengthen automations title for SEO and match sidebar label

[warp-factories]

Summary

Automated SEO audit of docs.warp.dev found 7 title_too_short warnings across 380 pages. Six match intentional allowlisted short titles. This PR fixes the remaining page by giving factory automations a descriptive frontmatter title, and (per review feedback) a matching sidebar label.

Changes

src/content/docs/factories/automations.mdx

• title: Automations → title: Factory automations
• sidebar.label: Automations → sidebar.label: Factory automations

src/sidebar.ts

• Updated the factories/automations sidebar override to label: 'Factory automations' to match the rendered label above.

Audit notes

Allowlisted short titles left unchanged:

• Guides
• Changelog
• Artifacts
• Tab Configs
• Split panes
• Tabs

Rework changes

Addressed review feedback from @rachaelrenk (requester @hongyi-chen agreed):

• Sidebar label consistency (implemented, thread has no inline GraphQL thread — it's a top-level PR conversation comment, replied to directly): the "Factory configuration" sidebar group's two preceding entries are "Factory agents" and "Factory skills". Renamed this page's sidebar label from "Automations" to "Factory automations" to match, in both the page frontmatter (sidebar.label) and the src/sidebar.ts override that renders it, so the two never desync. Left the two following siblings ("Definitions as code", "Infrastructure & security") unchanged since neither the comment nor the requester's agreement asked for a broader group rename.
• Verified via npm run build (build succeeds, rendered dist/client/factories/automations/index.html shows "Factory automations" in the sidebar nav, page title, and H1) and .agents/skills/check_for_broken_links/check_links.py --internal-only (0 broken links across 380 files / 3967 internal links).

Originating thread: https://warpdev.slack.com/archives/C09BVK0PL3Y/p1788311846296959

Co-Authored-By: Warp agent@warp.dev

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
docs	Ready	Preview	Sep 2, 2026 1:35am UTC

[warp-factories]

This PR was generated with Warp.

Comment @warp-agent on this PR to send it follow-up work.

 

[warp-for-oss]

@rachaelrenk

I'm starting a first review of this pull request.

You can view the conversation on Warp.

I completed the review and no human review was requested for this pull request.

Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

[rachaelrenk]

If we're going to rename the page title for SEO (which I've wondered if we should add "Factories"...), we should consider updating the sidebar label as well. The preceding two pages both have start with "Factory", so "Factory automations" would match the pattern. Of course, all of these are in the "Factory configuration" group so "Factory" is kind of implied. Thoughts?

[warp-for-oss]

Overview

This PR updates the factory automations page frontmatter title from Automations to Factory automations while preserving the short sidebar label. The change is scoped to SEO title clarity and aligns with nearby factory page title patterns.

Concerns

• No blocking concerns found.
• No approved spec context was provided, so there is no implementation spec drift to assess.
• No security-relevant code or configuration changes were introduced.

Verdict

Found: 0 critical, 0 important, 0 suggestions

Approve

Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

[warp-agent-staging]

@rachaelrenk Agreed, and Hongyi confirmed as well — updated.

The "Factory configuration" group's two preceding entries are Factory agents and Factory skills, so I renamed this page's sidebar label from "Automations" to "Factory automations" to match. I updated it in both places that control it: the page's own sidebar.label frontmatter and the src/sidebar.ts override that actually renders the nav entry (the override takes precedence, so both had to change together to avoid a desync).

I left the two pages after this one in the group — "Definitions as code" and "Infrastructure & security" — unprefixed, since neither your comment nor Hongyi's reply asked for a broader rename across the section; happy to revisit if you'd like those touched too.

Verified with npm run build (the rendered sidebar nav, page title, and H1 all show "Factory automations") and the repo's internal broken-link checker (0 broken links).

[warp-agent-staging]

Overview

The rework correctly makes the page title and both sidebar sources read "Factory automations," matching the adjacent Factory configuration pages. CI, the docs build, and the internal-link audit pass, and the generated navigation and llms index carry the new label.

Findings

Found: 0 critical, 1 important, 0 suggestions, 0 nits

Verdict

Request changes — add current visual proof of the rendered navigation change to the PR before merge.

[warp-agent-staging]

⚠️ [IMPORTANT] This user-facing sidebar change has no visual proof attached to the PR. Add a current screenshot of the rendered docs page showing the active Factory automations sidebar item and the matching page H1, then include it in the PR's artifacts block. The static render is sufficient here; no interaction needs to be recorded.