Skip to content

docs: metadata batch 2 from the AEO tracker (30 live-verified weak pages) - #1507

Draft
nav-tej wants to merge 1 commit into
mainfrom
nav/docs-metadata-batch2
Draft

docs: metadata batch 2 from the AEO tracker (30 live-verified weak pages)#1507
nav-tej wants to merge 1 commit into
mainfrom
nav/docs-metadata-batch2

Conversation

@nav-tej

@nav-tej nav-tej commented Aug 26, 2026

Copy link
Copy Markdown

What

Second metadata batch from the "SEO fixes and AEO Opportunities" tracker (sheet — see the new Claude Recs 2026-08-25 tab for the full per-URL breakdown), following #1482.

Because metadata passes land here daily, every candidate was re-verified against production tonight: of 209 English tracker URLs, 136 already carry solid descriptions (recent passes covered the biggest pages). This PR is only the 30 that are still weak right now — filler openers ("This guide will..."), too-short (34-68 chars), or title echoes — each rewritten from the page's actual content. Combined reach: ~2.1M GSC impressions/30d.

  • Frontmatter only: descriptions on all 30; titles only where weak (node-page stubs like "Ksampler", em-dash titles). sidebarTitle preserved or added wherever a title changed, so no navigation label moves.
  • English only; zh/ja/ko twins follow the translate pipeline.
  • No em dashes, no marketing tone, per the repo prose rules.

Two findings for a separate decision (not in this PR)

  1. 41 api-reference pages have no meta description at all — they're auto-generated from the OpenAPI spec, so the fix belongs in the spec/Mintlify config, not per-page .mdx edits.
  2. The question-headings half of the tracker is essentially unaddressed: of 72 flagged pages, only 6 have any question-format heading today, including the two biggest (krea-2 at 574k impressions, the docs homepage at 548k). docs: sharpen search metadata on the highest-traffic installation and basics pages #1482 established the safe pattern ({#custom-id} pins preserve anchors) if we want a batch 3.

cc @comfyui-wiki — draft for your review; happy to split or trim.

🤖 Generated with Claude Code

… only

30 pages whose descriptions are still filler, too short, or title echoes
after the recent metadata passes, re-verified against production tonight
and rewritten from each page's actual content. Titles changed only where
weak; sidebarTitle preserved or added so navigation labels do not move.
Recommendations tracker: SEO fixes and AEO Opportunities sheet (Claude
Recs tab).
@mintlify

mintlify Bot commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
comfy 🟢 Ready View Preview Aug 26, 2026, 5:59 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@coderabbitai

coderabbitai Bot commented Aug 26, 2026

Copy link
Copy Markdown

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

Copy link
Copy Markdown

🌐 i18n translation sync reminder

@comfyui-wiki English documentation was updated in this PR. Please complete or schedule translation updates for the following files:

Japanese (ja)

  • ja/basic-concepts/custom-nodes.mdx
  • ja/basic-concepts/nodes.mdx
  • ja/development/comfyui-server/startup-flags.mdx
  • ja/installation/desktop/linux.mdx
  • ja/installation/desktop/overview.mdx
  • ja/interface/credits.mdx
  • ja/interface/nodes-2.mdx
  • ja/interface/overview.mdx
  • ja/interface/shortcuts.mdx
  • ja/manager/configuration.mdx
  • ja/manager/troubleshooting.mdx
  • ja/specs/workflow_json.mdx
  • ja/troubleshooting/custom-node-issues.mdx
  • ja/troubleshooting/overview.mdx
  • ja/tutorials/3d/hunyuan3D-2.mdx
  • ja/tutorials/audio/ace-step/ace-step-v1.mdx
  • ja/tutorials/basic/inpaint.mdx
  • ja/tutorials/basic/outpaint.mdx
  • ja/tutorials/controlnet/controlnet.mdx
  • ja/tutorials/controlnet/depth-controlnet.mdx
  • ja/tutorials/flux/flux-1-controlnet.mdx
  • ja/tutorials/flux/flux-1-kontext-dev.mdx
  • ja/tutorials/image/ideogram/ideogram-v4.mdx
  • ja/tutorials/partner-nodes/luma/luma-image-to-video.mdx
  • ja/tutorials/partner-nodes/overview.mdx
  • ja/tutorials/partner-nodes/pricing.mdx
  • ja/tutorials/video/wan/wan-ati.mdx

Simplified Chinese (zh)

  • zh/basic-concepts/custom-nodes.mdx
  • zh/basic-concepts/nodes.mdx
  • zh/development/comfyui-server/startup-flags.mdx
  • zh/installation/desktop/linux.mdx
  • zh/installation/desktop/overview.mdx
  • zh/interface/credits.mdx
  • zh/interface/nodes-2.mdx
  • zh/interface/overview.mdx
  • zh/interface/shortcuts.mdx
  • zh/manager/configuration.mdx
  • zh/manager/troubleshooting.mdx
  • zh/specs/workflow_json.mdx
  • zh/troubleshooting/custom-node-issues.mdx
  • zh/troubleshooting/overview.mdx
  • zh/tutorials/3d/hunyuan3D-2.mdx
  • zh/tutorials/audio/ace-step/ace-step-v1.mdx
  • zh/tutorials/basic/inpaint.mdx
  • zh/tutorials/basic/outpaint.mdx
  • zh/tutorials/controlnet/controlnet.mdx
  • zh/tutorials/controlnet/depth-controlnet.mdx
  • zh/tutorials/flux/flux-1-controlnet.mdx
  • zh/tutorials/flux/flux-1-kontext-dev.mdx
  • zh/tutorials/image/ideogram/ideogram-v4.mdx
  • zh/tutorials/partner-nodes/luma/luma-image-to-video.mdx
  • zh/tutorials/partner-nodes/overview.mdx
  • zh/tutorials/partner-nodes/pricing.mdx
  • zh/tutorials/video/wan/wan-ati.mdx

Korean (ko)

  • ko/basic-concepts/custom-nodes.mdx
  • ko/basic-concepts/nodes.mdx
  • ko/development/comfyui-server/startup-flags.mdx
  • ko/installation/desktop/linux.mdx
  • ko/installation/desktop/overview.mdx
  • ko/interface/credits.mdx
  • ko/interface/nodes-2.mdx
  • ko/interface/overview.mdx
  • ko/interface/shortcuts.mdx
  • ko/manager/configuration.mdx
  • ko/manager/troubleshooting.mdx
  • ko/specs/workflow_json.mdx
  • ko/troubleshooting/custom-node-issues.mdx
  • ko/troubleshooting/overview.mdx
  • ko/tutorials/3d/hunyuan3D-2.mdx
  • ko/tutorials/audio/ace-step/ace-step-v1.mdx
  • ko/tutorials/basic/inpaint.mdx
  • ko/tutorials/basic/outpaint.mdx
  • ko/tutorials/controlnet/controlnet.mdx
  • ko/tutorials/controlnet/depth-controlnet.mdx
  • ko/tutorials/flux/flux-1-controlnet.mdx
  • ko/tutorials/flux/flux-1-kontext-dev.mdx
  • ko/tutorials/image/ideogram/ideogram-v4.mdx
  • ko/tutorials/partner-nodes/luma/luma-image-to-video.mdx
  • ko/tutorials/partner-nodes/overview.mdx
  • ko/tutorials/partner-nodes/pricing.mdx
  • ko/tutorials/video/wan/wan-ati.mdx

Local sync: npm run translate (see README — Automated translation)

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