Skip to content

feat: improve GEO metadata and page headings#1216

Open
balpreetgrowthnatives wants to merge 1 commit into
Comfy-Org:mainfrom
balpreetgrowthnatives:balpreet/geo-docs-improvements
Open

feat: improve GEO metadata and page headings#1216
balpreetgrowthnatives wants to merge 1 commit into
Comfy-Org:mainfrom
balpreetgrowthnatives:balpreet/geo-docs-improvements

Conversation

@balpreetgrowthnatives

Copy link
Copy Markdown

Summary
Updated the H2 headings and meta descriptions for multiple built-in node documentation pages to improve SEO structure and citation opportunities.

Changes
What: Replaced generic section headings and boilerplate meta descriptions for the Canny, CLIPTextEncodeSDXLRefiner, GLSLShader, and OpenAI DALL-E 2 documentation pages with node-specific, question-based headings and descriptive metadata.

Review Focus
Please review the updated headings and meta descriptions to ensure they accurately describe each node's functionality and remain consistent with the corresponding documentation content.

@coderabbitai

coderabbitai Bot commented Jul 2, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

Updated the introductory copy and top-level headings across the main docs landing page, community links page, and several built-in node documentation pages. The changes make the openings more specific and question-style, in a tidy little wording waltz.

Changes

Docs landing and community pages

Layer / File(s) Summary
Landing and community copy
index.mdx, community/links.mdx
Updated front-matter descriptions and opening headings to use more specific ComfyUI, setup, and community-channel wording.

Built-in node documentation intros

Layer / File(s) Summary
Built-in node intro headings
built-in-nodes/Canny.mdx, built-in-nodes/ClipTextEncodeSdxlRefiner.mdx, built-in-nodes/GLSLShader.mdx, built-in-nodes/OpenAIDalle2.mdx
Reworded the front-matter descriptions and opening section headings for several built-in node docs to use more specific, question-style introductions.
🚥 Pre-merge checks | ✅ 2
✅ Passed checks (2 passed)
Check name Status Explanation
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
✨ Simplify code
  • Create PR with simplified code

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.

@balpreetgrowthnatives balpreetgrowthnatives force-pushed the balpreet/geo-docs-improvements branch from 25f889f to f914fe0 Compare July 2, 2026 12:48

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@built-in-nodes/ClipTextEncodeSdxlRefiner.mdx`:
- Around line 8-10: The intro for ClipTextEncodeSdxlRefiner is overstated and
suggests image/post-processing behavior that the node does not expose. Update
the opening copy in ClipTextEncodeSdxlRefiner.mdx to describe only the actual
inputs and behavior shown by the Inputs table: text-conditioning plus SDXL
refiner metadata such as aesthetic scores and dimensional information. Keep the
description aligned with CLIPTextEncodeSDXLRefiner and avoid implying it handles
preliminary images or later-stage refinement.

In `@community/links.mdx`:
- Around line 3-6: The page metadata and heading in the links MDX are out of
sync with the actual community cards. Update the description and the heading
text in community/links.mdx so they match the nine listed links and remove the
GitHub Discussions reference; keep the copy aligned with the content rendered by
the links page.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 598e209a-12a8-49d2-ada7-8d08c81479a2

📥 Commits

Reviewing files that changed from the base of the PR and between 25f889f and f914fe0.

📒 Files selected for processing (6)
  • built-in-nodes/Canny.mdx
  • built-in-nodes/ClipTextEncodeSdxlRefiner.mdx
  • built-in-nodes/GLSLShader.mdx
  • built-in-nodes/OpenAIDalle2.mdx
  • community/links.mdx
  • index.mdx

Comment on lines 8 to +10
This node is specifically designed for the SDXL Refiner model to convert text prompts into conditioning information by incorporating aesthetic scores and dimensional information to enhance the conditions for generation tasks, thereby improving the final refinement effect. It acts like a professional art director, not only conveying your creative intent but also injecting precise aesthetic standards and specification requirements into the work.

## About SDXL Refiner
## What is the CLIPTextEncodeSDXLRefiner node used for in SDXL workflows?

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Trim the intro to the node's actual inputs.

The opening paragraph reads like this node handles preliminary images, but the Inputs table shows only text-conditioning and refiner metadata. That makes it sound like a post-processing step it does not expose.

♻️ Suggested copy tweak
-This node is specifically designed for the SDXL Refiner model to convert text prompts into conditioning information by incorporating aesthetic scores and dimensional information to enhance the conditions for generation tasks, thereby improving the final refinement effect. It acts like a professional art director, not only conveying your creative intent but also injecting precise aesthetic standards and specification requirements into the work.
+This node converts text prompts into conditioning information for the SDXL Refiner stage. It uses the CLIP model together with `ascore`, `width`, and `height` to shape the final refinement pass.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
This node is specifically designed for the SDXL Refiner model to convert text prompts into conditioning information by incorporating aesthetic scores and dimensional information to enhance the conditions for generation tasks, thereby improving the final refinement effect. It acts like a professional art director, not only conveying your creative intent but also injecting precise aesthetic standards and specification requirements into the work.
## About SDXL Refiner
## What is the CLIPTextEncodeSDXLRefiner node used for in SDXL workflows?
This node converts text prompts into conditioning information for the SDXL Refiner stage. It uses the CLIP model together with `ascore`, `width`, and `height` to shape the final refinement pass.
## What is the CLIPTextEncodeSDXLRefiner node used for in SDXL workflows?
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@built-in-nodes/ClipTextEncodeSdxlRefiner.mdx` around lines 8 - 10, The intro
for ClipTextEncodeSdxlRefiner is overstated and suggests image/post-processing
behavior that the node does not expose. Update the opening copy in
ClipTextEncodeSdxlRefiner.mdx to describe only the actual inputs and behavior
shown by the Inputs table: text-conditioning plus SDXL refiner metadata such as
aesthetic scores and dimensional information. Keep the description aligned with
CLIPTextEncodeSDXLRefiner and avoid implying it handles preliminary images or
later-stage refinement.

Comment thread community/links.mdx
Comment on lines +3 to +6
description: "Join the ComfyUI community on Discord (7000 members), GitHub Discussions, and Reddit for support and workflow sharing."
---

## Where can you get ComfyUI support? Discord, GitHub, and 3 other community channels

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

git ls-files community/links.mdx
wc -l community/links.mdx
nl -ba community/links.mdx | sed -n '1,120p'

Repository: Comfy-Org/docs

Length of output: 235


🏁 Script executed:

#!/bin/bash
set -euo pipefail

sed -n '1,80p' community/links.mdx | cat -n

Repository: Comfy-Org/docs

Length of output: 1924


Align the heading and description with the community cards. The page lists 9 links, not “3 other community channels,” and it doesn’t include GitHub Discussions. Keep the copy in step with the page, or it’ll go off-channel.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@community/links.mdx` around lines 3 - 6, The page metadata and heading in the
links MDX are out of sync with the actual community cards. Update the
description and the heading text in community/links.mdx so they match the nine
listed links and remove the GitHub Discussions reference; keep the copy aligned
with the content rendered by the links page.

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