Skip to content

Add temporary note on v1.13 compatility requirements#2150

Merged
lightwalker-eth merged 2 commits into
docs/2115-add-scalability-story-to-ensnode-self-host-modulefrom
docs/add-temp-note-on-v1.13-compatibility
May 19, 2026
Merged

Add temporary note on v1.13 compatility requirements#2150
lightwalker-eth merged 2 commits into
docs/2115-add-scalability-story-to-ensnode-self-host-modulefrom
docs/add-temp-note-on-v1.13-compatibility

Conversation

@tk-o
Copy link
Copy Markdown
Member

@tk-o tk-o commented May 19, 2026

Lite PR

Tip: Review docs on the ENSNode PR process

Summary

  • Adds a temporary note highlighting the compatibility requirements for ENSNode v1.13 that is currently running in production.

Why

  • We need to be explicit about the breaking changes introduced to the Omnigraph API data model in ENSNode v1.14.

Testing

  • How this was tested.
  • If you didn't test it, say why.

Notes for Reviewer (Optional)

  • Anything non-obvious or worth a heads-up.

Pre-Review Checklist (Blocking)

  • This PR does not introduce significant changes and is low-risk to review quickly.
  • Relevant changesets are included (or are not required)

Copilot AI review requested due to automatic review settings May 19, 2026 12:45
@tk-o tk-o requested a review from a team as a code owner May 19, 2026 12:45
@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented May 19, 2026

⚠️ No Changeset found

Latest commit: c504fc4

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

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 19, 2026

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 5c8eb17c-b48c-4943-9b8f-843f01458896

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:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/add-temp-note-on-v1.13-compatibility

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

Adds a temporary version-compatibility notice across the SDK READMEs, example READMEs, and integration docs warning users that the hosted ENSNode instances run v1.13 and that they must pin enssdk@1.13.1 / enskit@1.13.1 rather than the latest 1.14.0+ releases. Introduces a reusable HostedInstanceSdkVersionWarning.astro component and threads a for prop through IntegrateHostedEnsNodeTip.astro to control which SDKs are mentioned.

Changes:

  • New HostedInstanceSdkVersionWarning.astro component, embedded in the hosted-instances, integrate, enssdk/enskit guide, and playground pages.
  • README notices added in packages/enssdk, packages/enskit, and the four example READMEs.
  • IntegrateHostedEnsNodeTip.astro now accepts a for prop and renders the new warning; existing usages updated to pass it.

Reviewed changes

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

Show a summary per file
File Description
packages/enssdk/README.md Adds version-compatibility blockquote with pinned install command.
packages/enskit/README.md Adds package summary, Installation section, and pinned-version notice.
examples/omnigraph-graphql-example/README.md Adds hosted-instance version warning.
examples/enssdk-example/README.md Adds hosted-instance version warning.
examples/enskit-react-example/README.md Adds hosted-instance version warning (mentions both packages).
docs/…/enssdk/index.mdx Switches tip to caution; adds explicit v1.13 pin guidance; passes for="enssdk".
docs/…/enssdk/example.mdx Imports and renders the new warning component.
docs/…/enskit/index.mdx Switches tip to caution; adds explicit v1.13 pin guidance; passes for="enskit".
docs/…/enskit/example.mdx Imports and renders the new warning component.
docs/…/integrate/index.mdx Renders the warning above the enskit and enssdk code samples.
docs/…/hosted-instances.mdx Renders the warning with for="both".
docs/…/IntegrateHostedEnsNodeTip.astro Adds for prop and embeds the new warning.
docs/…/HostedInstanceSdkVersionWarning.astro New reusable warning component.

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

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented May 19, 2026

Greptile Summary

This PR adds a temporary compatibility notice across docs, package READMEs, and example READMEs warning users that the NameHash-hosted ENSNode instances run v1.13, while the latest published SDKs (1.14.0+) contain breaking Omnigraph API data-model changes not yet deployed there.

  • A new reusable HostedInstanceSdkVersionWarning.astro component encapsulates the caution block with three variants (enssdk, enskit, both); it uses HTML tags and set:html correctly, resolving the previously flagged markdown-in-Astro-template rendering issue.
  • The IntegrateHostedEnsNodeTip component now accepts and passes through the for prop (defaulting to \"both\"), which implicitly adds the warning to omnigraph-graphql-api.mdx as a side-effect of the default change — that file was not updated in the PR.
  • All example and package READMEs receive a consistent markdown blockquote with pinned @1.13.1 install commands.

Confidence Score: 5/5

Documentation-only change adding temporary compatibility warnings; no runtime logic is affected.

All changes are documentation and Astro component additions. The new component renders HTML correctly (previous markdown-in-template issues were fixed). The only notable side-effect is that omnigraph-graphql-api.mdx will now display the version warning via the changed default on IntegrateHostedEnsNodeTip, but the warning content is appropriate for that page.

No files require special attention beyond the implicit change to omnigraph-graphql-api.mdx via the updated IntegrateHostedEnsNodeTip default.

Important Files Changed

Filename Overview
docs/ensnode.io/src/components/molecules/HostedInstanceSdkVersionWarning.astro New Astro component rendering a version-compatibility caution block; uses HTML tags and set:html correctly, addressing previously flagged markdown-in-template issues.
docs/ensnode.io/src/components/molecules/IntegrateHostedEnsNodeTip.astro Extended to accept a for prop and render HostedInstanceSdkVersionWarning; the new default ("both") silently adds the warning to omnigraph-graphql-api.mdx, which was not updated in this PR.
docs/ensnode.io/src/content/docs/docs/integrate/integration-options/enssdk/example.mdx Adds version warning and fixes the pre-existing duplicate "The editor runs entirely in your browser" sentence.
packages/enskit/README.md Adds real package description and installation section; the legacy "package name is reserved" placeholder line now contradicts the new content.
packages/enssdk/README.md Adds version-compatibility blockquote after the main install command; wording matches the other README notices.
docs/ensnode.io/src/content/docs/docs/integrate/hosted-instances.mdx Adds HostedInstanceSdkVersionWarning for="both" above the hosted-instances table; straightforward and correct.
docs/ensnode.io/src/content/docs/docs/integrate/index.mdx Inserts version-compatibility warnings before enskit and enssdk code examples; changes are additive and scoped correctly.
docs/ensnode.io/src/content/docs/docs/integrate/integration-options/enskit/index.mdx Adds for="enskit" to IntegrateHostedEnsNodeTip and upgrades the tip callout to a caution with the v1.13 compatibility note.
docs/ensnode.io/src/content/docs/docs/integrate/integration-options/enssdk/index.mdx Mirrors enskit/index.mdx changes for the enssdk guide; caution callout added, for prop threaded correctly.
examples/enskit-react-example/README.md Adds a markdown blockquote compatibility warning before the usage snippet; clear and consistent with the other example READMEs.
examples/enssdk-example/README.md Adds the same compatibility blockquote pattern as the enskit-react-example README.
examples/omnigraph-graphql-example/README.md Adds compatibility warning mentioning both enssdk and enskit (with React qualifier), appropriate for the omnigraph guide audience.
docs/ensnode.io/src/content/docs/docs/integrate/integration-options/enskit/example.mdx Adds version warning above the interactive playground note; straightforward additive change.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["HostedInstanceSdkVersionWarning.astro\n(for: 'enssdk' | 'enskit' | 'both')"] --> B{target}
    B -->|enssdk| C["Show enssdk@1.13.1 warning\nnpm install enssdk@1.13.1"]
    B -->|enskit| D["Show enskit+enssdk warning\nnpm install enskit@1.13.1 enssdk@1.13.1"]
    B -->|both| E["Show both SDKs warning\n(enssdk first, enskit optional for React)"]
    F["IntegrateHostedEnsNodeTip.astro\n(for: default='both')"] -->|passes for prop| A
    G[hosted-instances.mdx] -->|for=both| A
    H[integrate/index.mdx] -->|for=enskit| A
    H -->|for=enssdk| A
    I[enskit/index.mdx] -->|for=enskit| F
    J[enssdk/index.mdx] -->|for=enssdk| F
    K[enskit/example.mdx] -->|for=enskit| A
    L[enssdk/example.mdx] -->|for=enssdk| A
    M["omnigraph-graphql-api.mdx\n(no for prop → default 'both')"] --> F
Loading

Reviews (3): Last reviewed commit: "Fix markdown in astro" | Re-trigger Greptile

Comment thread docs/ensnode.io/src/components/molecules/HostedInstanceSdkVersionWarning.astro Outdated
Comment thread docs/ensnode.io/src/components/molecules/HostedInstanceSdkVersionWarning.astro Outdated
Copilot AI review requested due to automatic review settings May 19, 2026 14:24
@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented May 19, 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 May 19, 2026 2:25pm
ensnode.io Ready Ready Preview, Comment May 19, 2026 2:25pm
2 Skipped Deployments
Project Deployment Actions Updated (UTC)
admin.ensnode.io Skipped Skipped May 19, 2026 2:25pm
ensrainbow.io Skipped Skipped May 19, 2026 2:25pm

@tk-o
Copy link
Copy Markdown
Member Author

tk-o commented May 19, 2026

@greptile review

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 13 out of 13 changed files in this pull request and generated no new comments.

Copy link
Copy Markdown
Member

@lightwalker-eth lightwalker-eth left a comment

Choose a reason for hiding this comment

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

@tk-o Thanks for this! Looks good! 👍

@lightwalker-eth lightwalker-eth merged commit 6c59d33 into docs/2115-add-scalability-story-to-ensnode-self-host-module May 19, 2026
15 checks passed
@lightwalker-eth lightwalker-eth deleted the docs/add-temp-note-on-v1.13-compatibility branch May 19, 2026 21:00
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.

4 participants