Skip to content

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

Merged
comfyui-wiki merged 3 commits into
mainfrom
nav/docs-metadata-batch2
Aug 26, 2026
Merged

docs: metadata batch 2 from the AEO tracker (30 live-verified weak pages)#1507
comfyui-wiki merged 3 commits into
mainfrom
nav/docs-metadata-batch2

Conversation

@nav-tej

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

Copy link
Copy Markdown
Contributor

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

Review skipped

Too many files!

This PR contains 120 files, which is 20 over the limit of 100.

To get a review, reduce the PR to 100 files or fewer by splitting it into smaller PRs or changing its base branch.

Upgrade to a paid plan to raise the limit.

This review ran on the open-source allowance, not this organization's plan, because the pull request author doesn't have an assigned seat. Waiting won't change this — ask an organization admin to assign them a seat, or add seats in Billing if every seat is already assigned, then retry.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 4f7f2cce-6ef7-425f-880f-9a1df7795ac3

📥 Commits

Reviewing files that changed from the base of the PR and between 1fd27a4 and 873ce8b.

📒 Files selected for processing (120)
  • basic-concepts/custom-nodes.mdx
  • basic-concepts/nodes.mdx
  • built-in-nodes/CheckpointLoaderSimple.mdx
  • built-in-nodes/MultiGPU_WorkUnits.mdx
  • built-in-nodes/sampling/ksampler.mdx
  • development/comfyui-server/startup-flags.mdx
  • installation/desktop/linux.mdx
  • installation/desktop/overview.mdx
  • interface/credits.mdx
  • interface/nodes-2.mdx
  • interface/overview.mdx
  • interface/shortcuts.mdx
  • ja/basic-concepts/custom-nodes.mdx
  • ja/basic-concepts/nodes.mdx
  • ja/built-in-nodes/CheckpointLoaderSimple.mdx
  • ja/built-in-nodes/MultiGPU_WorkUnits.mdx
  • ja/built-in-nodes/sampling/ksampler.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
  • ko/basic-concepts/custom-nodes.mdx
  • ko/basic-concepts/nodes.mdx
  • ko/built-in-nodes/CheckpointLoaderSimple.mdx
  • ko/built-in-nodes/MultiGPU_WorkUnits.mdx
  • ko/built-in-nodes/sampling/ksampler.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
  • manager/configuration.mdx
  • manager/troubleshooting.mdx
  • specs/workflow_json.mdx
  • troubleshooting/custom-node-issues.mdx
  • troubleshooting/overview.mdx
  • tutorials/3d/hunyuan3D-2.mdx
  • tutorials/audio/ace-step/ace-step-v1.mdx
  • tutorials/basic/inpaint.mdx
  • tutorials/basic/outpaint.mdx
  • tutorials/controlnet/controlnet.mdx
  • tutorials/controlnet/depth-controlnet.mdx
  • tutorials/flux/flux-1-controlnet.mdx
  • tutorials/flux/flux-1-kontext-dev.mdx
  • tutorials/image/ideogram/ideogram-v4.mdx
  • tutorials/partner-nodes/luma/luma-image-to-video.mdx
  • tutorials/partner-nodes/overview.mdx
  • tutorials/partner-nodes/pricing.mdx
  • tutorials/video/wan/wan-ati.mdx
  • zh/basic-concepts/custom-nodes.mdx
  • zh/basic-concepts/nodes.mdx
  • zh/built-in-nodes/CheckpointLoaderSimple.mdx
  • zh/built-in-nodes/MultiGPU_WorkUnits.mdx
  • zh/built-in-nodes/sampling/ksampler.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

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • Review on demand using usage pricing

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)

Update title/description translations for the 30 pages whose English
frontmatter changed in this PR (nav/docs-metadata-batch2), and refresh
translationSourceHash. ko ksampler has no translation file (pre-existing
gap), left untouched.
@comfyui-wiki
comfyui-wiki marked this pull request as ready for review August 26, 2026 12:55
@comfyui-wiki
comfyui-wiki merged commit 5155741 into main Aug 26, 2026
11 checks passed
@github-actions
github-actions Bot deleted the nav/docs-metadata-batch2 branch August 26, 2026 12:56
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.

2 participants