Skip to content

docs(partner-nodes): consolidate Overview/Workflow subpages back to single model pages - #1563

Draft
comfyui-wiki wants to merge 3 commits into
mainfrom
docs/partner-nodes-consolidate
Draft

docs(partner-nodes): consolidate Overview/Workflow subpages back to single model pages#1563
comfyui-wiki wants to merge 3 commits into
mainfrom
docs/partner-nodes-consolidate

Conversation

@comfyui-wiki

Copy link
Copy Markdown
Member

Summary

Consolidates the Partner Nodes model pages back to one page per model, reverting the per-model Overview + Workflow subpage split introduced in #1532, while keeping Robin's category structure (Image / Video / 3D / Audio / LLMs).

Motivation

The #1532 split created one Overview page and one Workflow subpage for every model, regardless of content volume. Many model pages are only 12–28 lines — thin, templated "What X is good at" stubs that don't justify two pages. This PR:

  • Merges each xxx.mdx (Overview) + xxx/workflow.mdx back into a single model page (68 pages consolidated)
  • Deletes the 68 workflow.mdx subpages
  • Rewrites the 5 category overviews (image/video/3d/audio/language) from 6-line placeholder intros into real selection guides: what the category does, how to choose a model by task, and a full per-partner model table with links
  • Flattens the docs.json nav (drops the Workflow sub-entries, 4 locales)
  • Adds 284 redirects from /<model>/workflow/<model> (en + zh/ja/ko) so existing links keep working

What stays

  • Robin's category structure (Image / Video / 3D / Audio / LLMs) is kept
  • The partner-level grouping under each category is kept
  • All model content is preserved — workflow content is merged into the single page, not dropped

What's deferred

  • zh / ja / ko translations: intentionally not included yet. We want internal consensus on the structure before spending a full translation pass (the structure change invalidates the current translations anyway). Once the structure is agreed, run npm run translate and add the translations in a follow-up commit.
  • See Reorganize partner node docs with Overview/Workflow structure #1532 (original split) and the Router work for related context.

Testing

  • docs.json parses; nav has no /workflow entries for partner nodes
  • No internal links to deleted /workflow pages remain
  • 5 category overviews' links all resolve to existing pages
  • CI (anchor check, link validation, mint-checks) will run on this PR

Draft status: this is a structural proposal — holding for review/consensus before merge.

…ingle model pages

Revert the per-model page split introduced in #1532: merge each
xxx.mdx (Overview) + xxx/workflow.mdx back into a single model page,
and remove the 68 workflow subpages.

- 68 model pages consolidated (workflow content merged into main page,
  sidebarTitle changed from 'Overview' to the model name)
- 68 workflow.mdx subpages deleted
- Category overviews (image/video/3d/audio/language) rewritten from
  placeholder intros into real selection guides: what the category does,
  how to choose a model by task, and a full per-partner model table
- docs.json: flatten model nav groups, drop workflow sub-entries
  (4 locales), add 284 redirects from /<model>/workflow to /<model>
- No English content removed; translations (zh/ja/ko) deferred until
  internal consensus on the structure (PR kept as draft)
@mintlify

mintlify Bot commented Aug 31, 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 31, 2026, 2:52 AM

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

@coderabbitai

coderabbitai Bot commented Aug 31, 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

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/tutorials/partner-nodes/3d/overview.mdx
  • ja/tutorials/partner-nodes/anthropic/claude.mdx
  • ja/tutorials/partner-nodes/audio/overview.mdx
  • ja/tutorials/partner-nodes/beeble/beeble-switchx.mdx
  • ja/tutorials/partner-nodes/black-forest-labs/flux-1-1-pro-ultra-image.mdx
  • ja/tutorials/partner-nodes/black-forest-labs/flux-1-kontext.mdx
  • ja/tutorials/partner-nodes/black-forest-labs/flux-3-video.mdx
  • ja/tutorials/partner-nodes/black-forest-labs/flux-video-upscale.mdx
  • ja/tutorials/partner-nodes/bria/background-removal.mdx
  • ja/tutorials/partner-nodes/bria/fibo.mdx
  • ja/tutorials/partner-nodes/bria/image-editing.mdx
  • ja/tutorials/partner-nodes/bytedance/seed-audio-1-0.mdx
  • ja/tutorials/partner-nodes/bytedance/seedance-2-0-real-human.mdx
  • ja/tutorials/partner-nodes/bytedance/seedance-2-0.mdx
  • ja/tutorials/partner-nodes/bytedance/seedance-2-5.mdx
  • ja/tutorials/partner-nodes/bytedance/seedream-5-lite.mdx
  • ja/tutorials/partner-nodes/bytedance/seedream-5-pro.mdx
  • ja/tutorials/partner-nodes/bytedance/vcube.mdx
  • ja/tutorials/partner-nodes/google/gemini-omni-flash.mdx
  • ja/tutorials/partner-nodes/google/gemini.mdx
  • ja/tutorials/partner-nodes/google/nano-banana-2-lite.mdx
  • ja/tutorials/partner-nodes/google/nano-banana-2.mdx
  • ja/tutorials/partner-nodes/google/nano-banana-pro.mdx
  • ja/tutorials/partner-nodes/grok/grok-image-2-0.mdx
  • ja/tutorials/partner-nodes/grok/grok-image-quality.mdx
  • ja/tutorials/partner-nodes/grok/grok-image.mdx
  • ja/tutorials/partner-nodes/grok/grok-imagine-video-1-5.mdx
  • ja/tutorials/partner-nodes/grok/grok-video.mdx
  • ja/tutorials/partner-nodes/happyhorse/happyhorse1-0.mdx
  • ja/tutorials/partner-nodes/happyhorse/happyhorse1-1.mdx
  • ja/tutorials/partner-nodes/hunyuan3d/hunyuan3d-3-0.mdx
  • ja/tutorials/partner-nodes/ideogram/ideogram-p-image.mdx
  • ja/tutorials/partner-nodes/ideogram/ideogram-v4.mdx
  • ja/tutorials/partner-nodes/image/overview.mdx
  • ja/tutorials/partner-nodes/kling/kling-3-0.mdx
  • ja/tutorials/partner-nodes/kling/kling-motion-control.mdx
  • ja/tutorials/partner-nodes/krea2/krea2-t2i.mdx
  • ja/tutorials/partner-nodes/language/overview.mdx
  • ja/tutorials/partner-nodes/lightricks/ltx-2-5.mdx
  • ja/tutorials/partner-nodes/luma/luma-image-to-image.mdx
  • ja/tutorials/partner-nodes/luma/luma-image-to-video.mdx
  • ja/tutorials/partner-nodes/luma/luma-text-to-image.mdx
  • ja/tutorials/partner-nodes/luma/luma-text-to-video.mdx
  • ja/tutorials/partner-nodes/luma/luma-uni-1.mdx
  • ja/tutorials/partner-nodes/meshy/meshy-6.mdx
  • ja/tutorials/partner-nodes/meshy/meshy-7.mdx
  • ja/tutorials/partner-nodes/minimax/minimax-h3.mdx
  • ja/tutorials/partner-nodes/moonvalley/moonvalley-video-generation.mdx
  • ja/tutorials/partner-nodes/openai/chat.mdx
  • ja/tutorials/partner-nodes/openai/dall-e-2.mdx
  • ja/tutorials/partner-nodes/openai/dall-e-3.mdx
  • ja/tutorials/partner-nodes/openai/gpt-image-1.mdx
  • ja/tutorials/partner-nodes/openai/gpt-image-2.mdx
  • ja/tutorials/partner-nodes/openrouter/llm.mdx
  • ja/tutorials/partner-nodes/qwen/qwen-image-3-0-pro.mdx
  • ja/tutorials/partner-nodes/recraft/recraft-text-to-image.mdx
  • ja/tutorials/partner-nodes/recraft/recraft-v4.mdx
  • ja/tutorials/partner-nodes/reve/reve-image.mdx
  • ja/tutorials/partner-nodes/rodin/model-generation.mdx
  • ja/tutorials/partner-nodes/runway/image-generation.mdx
  • ja/tutorials/partner-nodes/runway/video-generation.mdx
  • ja/tutorials/partner-nodes/sonilo/video-to-music.mdx
  • ja/tutorials/partner-nodes/topaz/astra-2.mdx
  • ja/tutorials/partner-nodes/topaz/image-enhance-bloom-2.mdx
  • ja/tutorials/partner-nodes/topaz/image-enhance-wonder-3-5.mdx
  • ja/tutorials/partner-nodes/topaz/video-enhance-astra.mdx
  • ja/tutorials/partner-nodes/topaz/video-enhance-starlight-precise-2-5.mdx
  • ja/tutorials/partner-nodes/tripo/model-generation.mdx
  • ja/tutorials/partner-nodes/tripo/tripo-3-1.mdx
  • ja/tutorials/partner-nodes/tripo/tripo-p1.mdx
  • ja/tutorials/partner-nodes/video/overview.mdx
  • ja/tutorials/partner-nodes/wan/wan2-7.mdx
  • ja/tutorials/partner-nodes/wan/wan3-0.mdx

Simplified Chinese (zh)

  • zh/tutorials/partner-nodes/3d/overview.mdx
  • zh/tutorials/partner-nodes/anthropic/claude.mdx
  • zh/tutorials/partner-nodes/audio/overview.mdx
  • zh/tutorials/partner-nodes/beeble/beeble-switchx.mdx
  • zh/tutorials/partner-nodes/black-forest-labs/flux-1-1-pro-ultra-image.mdx
  • zh/tutorials/partner-nodes/black-forest-labs/flux-1-kontext.mdx
  • zh/tutorials/partner-nodes/black-forest-labs/flux-3-video.mdx
  • zh/tutorials/partner-nodes/black-forest-labs/flux-video-upscale.mdx
  • zh/tutorials/partner-nodes/bria/background-removal.mdx
  • zh/tutorials/partner-nodes/bria/fibo.mdx
  • zh/tutorials/partner-nodes/bria/image-editing.mdx
  • zh/tutorials/partner-nodes/bytedance/seed-audio-1-0.mdx
  • zh/tutorials/partner-nodes/bytedance/seedance-2-0-real-human.mdx
  • zh/tutorials/partner-nodes/bytedance/seedance-2-0.mdx
  • zh/tutorials/partner-nodes/bytedance/seedance-2-5.mdx
  • zh/tutorials/partner-nodes/bytedance/seedream-5-lite.mdx
  • zh/tutorials/partner-nodes/bytedance/seedream-5-pro.mdx
  • zh/tutorials/partner-nodes/bytedance/vcube.mdx
  • zh/tutorials/partner-nodes/google/gemini-omni-flash.mdx
  • zh/tutorials/partner-nodes/google/gemini.mdx
  • zh/tutorials/partner-nodes/google/nano-banana-2-lite.mdx
  • zh/tutorials/partner-nodes/google/nano-banana-2.mdx
  • zh/tutorials/partner-nodes/google/nano-banana-pro.mdx
  • zh/tutorials/partner-nodes/grok/grok-image-2-0.mdx
  • zh/tutorials/partner-nodes/grok/grok-image-quality.mdx
  • zh/tutorials/partner-nodes/grok/grok-image.mdx
  • zh/tutorials/partner-nodes/grok/grok-imagine-video-1-5.mdx
  • zh/tutorials/partner-nodes/grok/grok-video.mdx
  • zh/tutorials/partner-nodes/happyhorse/happyhorse1-0.mdx
  • zh/tutorials/partner-nodes/happyhorse/happyhorse1-1.mdx
  • zh/tutorials/partner-nodes/hunyuan3d/hunyuan3d-3-0.mdx
  • zh/tutorials/partner-nodes/ideogram/ideogram-p-image.mdx
  • zh/tutorials/partner-nodes/ideogram/ideogram-v4.mdx
  • zh/tutorials/partner-nodes/image/overview.mdx
  • zh/tutorials/partner-nodes/kling/kling-3-0.mdx
  • zh/tutorials/partner-nodes/kling/kling-motion-control.mdx
  • zh/tutorials/partner-nodes/krea2/krea2-t2i.mdx
  • zh/tutorials/partner-nodes/language/overview.mdx
  • zh/tutorials/partner-nodes/lightricks/ltx-2-5.mdx
  • zh/tutorials/partner-nodes/luma/luma-image-to-image.mdx
  • zh/tutorials/partner-nodes/luma/luma-image-to-video.mdx
  • zh/tutorials/partner-nodes/luma/luma-text-to-image.mdx
  • zh/tutorials/partner-nodes/luma/luma-text-to-video.mdx
  • zh/tutorials/partner-nodes/luma/luma-uni-1.mdx
  • zh/tutorials/partner-nodes/meshy/meshy-6.mdx
  • zh/tutorials/partner-nodes/meshy/meshy-7.mdx
  • zh/tutorials/partner-nodes/minimax/minimax-h3.mdx
  • zh/tutorials/partner-nodes/moonvalley/moonvalley-video-generation.mdx
  • zh/tutorials/partner-nodes/openai/chat.mdx
  • zh/tutorials/partner-nodes/openai/dall-e-2.mdx
  • zh/tutorials/partner-nodes/openai/dall-e-3.mdx
  • zh/tutorials/partner-nodes/openai/gpt-image-1.mdx
  • zh/tutorials/partner-nodes/openai/gpt-image-2.mdx
  • zh/tutorials/partner-nodes/openrouter/llm.mdx
  • zh/tutorials/partner-nodes/qwen/qwen-image-3-0-pro.mdx
  • zh/tutorials/partner-nodes/recraft/recraft-text-to-image.mdx
  • zh/tutorials/partner-nodes/recraft/recraft-v4.mdx
  • zh/tutorials/partner-nodes/reve/reve-image.mdx
  • zh/tutorials/partner-nodes/rodin/model-generation.mdx
  • zh/tutorials/partner-nodes/runway/image-generation.mdx
  • zh/tutorials/partner-nodes/runway/video-generation.mdx
  • zh/tutorials/partner-nodes/sonilo/video-to-music.mdx
  • zh/tutorials/partner-nodes/topaz/astra-2.mdx
  • zh/tutorials/partner-nodes/topaz/image-enhance-bloom-2.mdx
  • zh/tutorials/partner-nodes/topaz/image-enhance-wonder-3-5.mdx
  • zh/tutorials/partner-nodes/topaz/video-enhance-astra.mdx
  • zh/tutorials/partner-nodes/topaz/video-enhance-starlight-precise-2-5.mdx
  • zh/tutorials/partner-nodes/tripo/model-generation.mdx
  • zh/tutorials/partner-nodes/tripo/tripo-3-1.mdx
  • zh/tutorials/partner-nodes/tripo/tripo-p1.mdx
  • zh/tutorials/partner-nodes/video/overview.mdx
  • zh/tutorials/partner-nodes/wan/wan2-7.mdx
  • zh/tutorials/partner-nodes/wan/wan3-0.mdx

Korean (ko)

  • ko/tutorials/partner-nodes/3d/overview.mdx
  • ko/tutorials/partner-nodes/anthropic/claude.mdx
  • ko/tutorials/partner-nodes/audio/overview.mdx
  • ko/tutorials/partner-nodes/beeble/beeble-switchx.mdx
  • ko/tutorials/partner-nodes/black-forest-labs/flux-1-1-pro-ultra-image.mdx
  • ko/tutorials/partner-nodes/black-forest-labs/flux-1-kontext.mdx
  • ko/tutorials/partner-nodes/black-forest-labs/flux-3-video.mdx
  • ko/tutorials/partner-nodes/black-forest-labs/flux-video-upscale.mdx
  • ko/tutorials/partner-nodes/bria/background-removal.mdx
  • ko/tutorials/partner-nodes/bria/fibo.mdx
  • ko/tutorials/partner-nodes/bria/image-editing.mdx
  • ko/tutorials/partner-nodes/bytedance/seed-audio-1-0.mdx
  • ko/tutorials/partner-nodes/bytedance/seedance-2-0-real-human.mdx
  • ko/tutorials/partner-nodes/bytedance/seedance-2-0.mdx
  • ko/tutorials/partner-nodes/bytedance/seedance-2-5.mdx
  • ko/tutorials/partner-nodes/bytedance/seedream-5-lite.mdx
  • ko/tutorials/partner-nodes/bytedance/seedream-5-pro.mdx
  • ko/tutorials/partner-nodes/bytedance/vcube.mdx
  • ko/tutorials/partner-nodes/google/gemini-omni-flash.mdx
  • ko/tutorials/partner-nodes/google/gemini.mdx
  • ko/tutorials/partner-nodes/google/nano-banana-2-lite.mdx
  • ko/tutorials/partner-nodes/google/nano-banana-2.mdx
  • ko/tutorials/partner-nodes/google/nano-banana-pro.mdx
  • ko/tutorials/partner-nodes/grok/grok-image-2-0.mdx
  • ko/tutorials/partner-nodes/grok/grok-image-quality.mdx
  • ko/tutorials/partner-nodes/grok/grok-image.mdx
  • ko/tutorials/partner-nodes/grok/grok-imagine-video-1-5.mdx
  • ko/tutorials/partner-nodes/grok/grok-video.mdx
  • ko/tutorials/partner-nodes/happyhorse/happyhorse1-0.mdx
  • ko/tutorials/partner-nodes/happyhorse/happyhorse1-1.mdx
  • ko/tutorials/partner-nodes/hunyuan3d/hunyuan3d-3-0.mdx
  • ko/tutorials/partner-nodes/ideogram/ideogram-p-image.mdx
  • ko/tutorials/partner-nodes/ideogram/ideogram-v4.mdx
  • ko/tutorials/partner-nodes/image/overview.mdx
  • ko/tutorials/partner-nodes/kling/kling-3-0.mdx
  • ko/tutorials/partner-nodes/kling/kling-motion-control.mdx
  • ko/tutorials/partner-nodes/krea2/krea2-t2i.mdx
  • ko/tutorials/partner-nodes/language/overview.mdx
  • ko/tutorials/partner-nodes/lightricks/ltx-2-5.mdx
  • ko/tutorials/partner-nodes/luma/luma-image-to-image.mdx
  • ko/tutorials/partner-nodes/luma/luma-image-to-video.mdx
  • ko/tutorials/partner-nodes/luma/luma-text-to-image.mdx
  • ko/tutorials/partner-nodes/luma/luma-text-to-video.mdx
  • ko/tutorials/partner-nodes/luma/luma-uni-1.mdx
  • ko/tutorials/partner-nodes/meshy/meshy-6.mdx
  • ko/tutorials/partner-nodes/meshy/meshy-7.mdx
  • ko/tutorials/partner-nodes/minimax/minimax-h3.mdx
  • ko/tutorials/partner-nodes/moonvalley/moonvalley-video-generation.mdx
  • ko/tutorials/partner-nodes/openai/chat.mdx
  • ko/tutorials/partner-nodes/openai/dall-e-2.mdx
  • ko/tutorials/partner-nodes/openai/dall-e-3.mdx
  • ko/tutorials/partner-nodes/openai/gpt-image-1.mdx
  • ko/tutorials/partner-nodes/openai/gpt-image-2.mdx
  • ko/tutorials/partner-nodes/openrouter/llm.mdx
  • ko/tutorials/partner-nodes/qwen/qwen-image-3-0-pro.mdx
  • ko/tutorials/partner-nodes/recraft/recraft-text-to-image.mdx
  • ko/tutorials/partner-nodes/recraft/recraft-v4.mdx
  • ko/tutorials/partner-nodes/reve/reve-image.mdx
  • ko/tutorials/partner-nodes/rodin/model-generation.mdx
  • ko/tutorials/partner-nodes/runway/image-generation.mdx
  • ko/tutorials/partner-nodes/runway/video-generation.mdx
  • ko/tutorials/partner-nodes/sonilo/video-to-music.mdx
  • ko/tutorials/partner-nodes/topaz/astra-2.mdx
  • ko/tutorials/partner-nodes/topaz/image-enhance-bloom-2.mdx
  • ko/tutorials/partner-nodes/topaz/image-enhance-wonder-3-5.mdx
  • ko/tutorials/partner-nodes/topaz/video-enhance-astra.mdx
  • ko/tutorials/partner-nodes/topaz/video-enhance-starlight-precise-2-5.mdx
  • ko/tutorials/partner-nodes/tripo/model-generation.mdx
  • ko/tutorials/partner-nodes/tripo/tripo-3-1.mdx
  • ko/tutorials/partner-nodes/tripo/tripo-p1.mdx
  • ko/tutorials/partner-nodes/video/overview.mdx
  • ko/tutorials/partner-nodes/wan/wan2-7.mdx
  • ko/tutorials/partner-nodes/wan/wan3-0.mdx

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

…ects

The zh/ja/ko workflow subpages never existed on main (only the English
versions were split in #1532). Redirects from /zh|/ja|/ko/.../workflow
pointed to URLs that were never live, and 4 English entries were also
bogus (core-concepts/workflow, grok-overview, model-generation,
ideogram-v3). Keep only the 68 real English workflow redirects.
Add a Browse models CardGroup right after the intro on each of the 5
category overview pages (image/video/3d/audio/language), with one Card
per model page in that category so readers can jump straight to a model.
Bottom partner tables are kept as the full index.
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