Skip to content

docs(ensnode.io): emotional red/green narrative framing in Why ENSNode pages#2253

Merged
shrugs merged 4 commits into
mainfrom
docs/why-ensnode-emotional-narrative
Jun 3, 2026
Merged

docs(ensnode.io): emotional red/green narrative framing in Why ENSNode pages#2253
shrugs merged 4 commits into
mainfrom
docs/why-ensnode-emotional-narrative

Conversation

@shrugs
Copy link
Copy Markdown
Member

@shrugs shrugs commented Jun 3, 2026

Apply caution-frame (red :::danger) / solution-frame (green :::tip) panels with nested LinkCards across the high-visibility Why ENSNode pages, per docs feedback. Pairs with the card-in-aside styling from #2233.

Changes

  • keep-ens-working: red panel above the fold linking to Key Limitations; Next Steps split into a red (problem) and green (solution) panel.
  • why-ensnode index: lead with the stakes (red panel), then the solution (green panel), then a single "How ENSNode delivers" proof cluster that folds in the former One unified API / Multichain / Full-stack sections (removing the awkward standalone "Multichain by default" heading).
  • ensv2-readiness: "Be ready!" panel blue → green + Omnigraph card; Key Limitations wrapped in a red panel.

shrugs added 2 commits June 3, 2026 11:02
…e pages

Apply caution-frame (red :::danger) / solution-frame (green :::tip) panels
with nested LinkCards across the high-visibility Why ENSNode pages, per
docs feedback. Pairs with the card-in-aside styling from PR #2233.

- keep-ens-working: red panel above the fold linking to Key Limitations;
  Next Steps split into a red (problem) and green (solution) panel.
- why-ensnode index: lead with the stakes (red panel), then the solution
  (green panel), then a single "How ENSNode delivers" proof cluster that
  folds in the former One unified API / Multichain / Full-stack sections
  (removing the awkward standalone "Multichain by default" heading).
- ensv2-readiness: "Be ready!" panel blue -> green + Omnigraph card;
  Key Limitations wrapped in a red panel.
Copilot AI review requested due to automatic review settings June 3, 2026 21:20
@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented Jun 3, 2026

⚠️ No Changeset found

Latest commit: 6d90a84

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented Jun 3, 2026

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

Project Deployment Actions Updated (UTC)
enskit-react-example.ensnode.io Ready Ready Preview, Comment Jun 3, 2026 10:00pm
ensnode.io Ready Ready Preview, Comment Jun 3, 2026 10:00pm
2 Skipped Deployments
Project Deployment Actions Updated (UTC)
admin.ensnode.io Skipped Skipped Jun 3, 2026 10:00pm
ensrainbow.io Skipped Skipped Jun 3, 2026 10:00pm

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Jun 3, 2026

Review Change Stack

Warning

Review limit reached

@shrugs, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 21 minutes and 56 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 96949786-a7f3-444d-bb25-7711d675b63a

📥 Commits

Reviewing files that changed from the base of the PR and between 5cf0695 and 6d90a84.

📒 Files selected for processing (2)
  • docs/ensnode.io/src/content/docs/docs/integrate/why-ensnode/index.mdx
  • docs/ensnode.io/src/content/docs/docs/integrate/why-ensnode/keep-ens-working.mdx
📝 Walkthrough

Walkthrough

Three documentation pages restructured to clarify ENSv2 compatibility messaging and promote the ENS Omnigraph API: ENSv2 readiness page reorganized with new callouts and link cards, Why ENSNode index page segmented to separate subgraph incompatibility from Omnigraph value proposition, and Keep ENS Working page updated with breaking-change warnings and migration call-to-action.

Changes

ENSv2 Readiness and Omnigraph Messaging

Layer / File(s) Summary
ENSv2 Readiness page restructure
docs/ensnode.io/src/content/docs/docs/integrate/why-ensnode/ensv2-readiness.mdx
"Be ready!" callout replaced with tip including Omnigraph API link card; historical limitations content cleaned to remove ENSv2 warning; new danger callout "It only gets harder with ENSv2" added with subgraph key-limitations link card.
Why ENSNode index page restructure
docs/ensnode.io/src/content/docs/docs/integrate/why-ensnode/index.mdx
"Built for ENSv2 from day one" replaced with segmented structure: "Subgraph won't survive ENSv2" danger callout with two link cards, "ENSNode is built for ENSv2" tip callout, rewrote "Three capabilities" section with unified API description, and simplified integration surfaces to single link card while removing prior call-to-action section.
Keep ENS Working page updates
docs/ensnode.io/src/content/docs/docs/integrate/why-ensnode/keep-ens-working.mdx
Top-level danger callout added warning ENSv2 breaks Subgraph-dependent apps; "Next Steps" section restructured with danger callout on Subgraph viability and tip callout promoting Omnigraph API adoption, both with updated link cards.

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly Related PRs

  • namehash/ensnode#2235: Both PRs modify the same ENSNode documentation pages (why-ensnode/ensv2-readiness.mdx, why-ensnode/index.mdx, why-ensnode/keep-ens-working.mdx) by updating ENSv2 readiness/subgraph compatibility messaging and link cards.
  • namehash/ensnode#2106: Both PRs edit the ENSv2 readiness documentation, adding/reworking readiness callouts and links around ENSv2/Omnigraph messaging.
  • namehash/ensnode#2204: Both PRs update multiple why-ensnode MDX pages to restructure callouts and LinkCard destinations toward ENS Subgraph key limitations and Omnigraph flow.

Suggested Labels

docs

Poem

🐰 A tale of readiness takes shape,
New callouts warn of ENSv2's cape,
Link cards guide to Omnigraph's way,
The docs evolve with each bright display!

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The PR description deviates from the template structure. It lacks the required 'Summary' and 'Why' sections, includes a 'Changes' section not in the template, omits 'Testing' and 'Pre-Review Checklist', and provides only informal bullet points instead of the requested format. Restructure the description to match the template: add a concise 'Summary' section (1-3 bullets), explain 'Why' this change exists with issue links, describe 'Testing' performed, and include the 'Pre-Review Checklist' with blocking items marked.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately describes the main change: applying emotional red/green narrative framing (danger and tip callouts) across the Why ENSNode documentation pages.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
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.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/why-ensnode-emotional-narrative

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 and usage tips.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR updates the high-visibility “Why ENSNode” documentation pages to use a clearer problem/solution narrative, framing ENS Subgraph risks in red danger panels and ENSNode’s Omnigraph path forward in green tip panels, with LinkCards embedded for quick navigation.

Changes:

  • Adds above-the-fold red danger framing and splits “Next Steps” into problem (red) vs solution (green) on Keep ENS apps working.
  • Reworks the Why ENSNode index to lead with stakes (red), then solution (green), and consolidates value props into a single “How ENSNode delivers” section.
  • Updates ENSv2 Readiness to use a green tip “Be ready!” panel with an Omnigraph LinkCard and wraps Subgraph limitations in a red danger panel.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File Description
docs/ensnode.io/src/content/docs/docs/integrate/why-ensnode/keep-ens-working.mdx Adds red “risk” framing above the fold and splits Next Steps into red problem vs green solution panels with LinkCards.
docs/ensnode.io/src/content/docs/docs/integrate/why-ensnode/index.mdx Reorders and consolidates the page narrative into stakes → solution → proof points, updating headings and LinkCard placement.
docs/ensnode.io/src/content/docs/docs/integrate/why-ensnode/ensv2-readiness.mdx Switches the lead Aside to tip, adds an Omnigraph LinkCard, and wraps Key Limitations in a danger Aside.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 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 `@docs/ensnode.io/src/content/docs/docs/integrate/why-ensnode/index.mdx`:
- Around line 14-27: The LinkCard instances for "Key Limitations of the ENS
Subgraph" are inconsistent; standardize all occurrences by using a single
canonical title and description (update the LinkCard props in every place where
LinkCard is used for this destination). Locate each LinkCard with
title/description props referencing "Subgraph" (the LinkCard component) and
replace their title with "Key Limitations of the ENS Subgraph 🚨" and
description with "The full list of ways the ENS Subgraph falls short today — and
why each one breaks with ENSv2." so all four instances use the exact same text.
🪄 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

Run ID: f98f8b5c-a10b-4e26-b307-1b51d408df38

📥 Commits

Reviewing files that changed from the base of the PR and between 61ee0ac and 5cf0695.

📒 Files selected for processing (3)
  • docs/ensnode.io/src/content/docs/docs/integrate/why-ensnode/ensv2-readiness.mdx
  • docs/ensnode.io/src/content/docs/docs/integrate/why-ensnode/index.mdx
  • docs/ensnode.io/src/content/docs/docs/integrate/why-ensnode/keep-ens-working.mdx

@vercel vercel Bot temporarily deployed to Preview – ensrainbow.io June 3, 2026 21:28 Inactive
@vercel vercel Bot temporarily deployed to Preview – admin.ensnode.io June 3, 2026 21:28 Inactive
@shrugs shrugs marked this pull request as ready for review June 3, 2026 21:28
@shrugs shrugs requested a review from a team as a code owner June 3, 2026 21:28
Copilot AI review requested due to automatic review settings June 3, 2026 21:28
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

Comment thread docs/ensnode.io/src/content/docs/docs/integrate/why-ensnode/index.mdx Outdated
@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented Jun 3, 2026

Greptile Summary

This PR applies emotional red/green narrative framing to three high-visibility "Why ENSNode" documentation pages, wrapping problem-oriented content in :::danger / <Aside type=\"danger\"> panels and solution-oriented content in :::tip / <Aside type=\"tip\"> panels with nested LinkCard calls-to-action.

  • index.mdx: Reorganizes the page to lead with a danger panel and a tip panel, condenses three former standalone sections into a single "How ENSNode delivers" block, and fixes the "Keep ENS apps working" href from /docs/integrate/ens-subgraph to /docs/integrate/why-ensnode/keep-ens-working.
  • keep-ens-working.mdx: Adds an above-the-fold danger hook panel and splits Next Steps into a danger/tip pair.
  • ensv2-readiness.mdx: Promotes "Be ready!" aside from type=\"note\" (blue) to type=\"tip\" (green), adds an Omnigraph LinkCard inside it, and wraps the ENSv2-complexity caveat in a new danger aside.

Confidence Score: 5/5

Documentation-only content restructuring with no logic, config, or code changes — safe to merge.

All three files contain only MDX prose and Starlight component markup. No broken link targets, no missing imports, and every component was already imported before this PR. The aside-syntax mix and duplicate Key Limitations cards were already acknowledged as intentional in prior review threads.

No files require special attention.

Important Files Changed

Filename Overview
docs/ensnode.io/src/content/docs/docs/integrate/why-ensnode/index.mdx Restructures the Why ENSNode landing page with danger/tip panels, consolidates three sections into one prose block, and fixes the Keep ENS apps working href.
docs/ensnode.io/src/content/docs/docs/integrate/why-ensnode/keep-ens-working.mdx Adds an above-the-fold danger hook panel and splits Next Steps into a danger/tip pair; duplicate Key Limitations card is intentional.
docs/ensnode.io/src/content/docs/docs/integrate/why-ensnode/ensv2-readiness.mdx Promotes Be ready! aside to green tip, adds Omnigraph LinkCard inside it, and wraps ENSv2-complexity sentence in a new danger aside.

Reviews (3): Last reviewed commit: "docs: standardize Key Limitations card t..." | Re-trigger Greptile

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@shrugs
Copy link
Copy Markdown
Member Author

shrugs commented Jun 3, 2026

@greptile review

@shrugs shrugs merged commit 3963eae into main Jun 3, 2026
20 checks passed
@shrugs shrugs deleted the docs/why-ensnode-emotional-narrative branch June 3, 2026 22:18
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