Skip to content

docs: ENSAnalytics#2152

Open
Goader wants to merge 2 commits into
mainfrom
docs/ensanalytics
Open

docs: ENSAnalytics#2152
Goader wants to merge 2 commits into
mainfrom
docs/ensanalytics

Conversation

@Goader
Copy link
Copy Markdown
Member

@Goader Goader commented May 19, 2026

ENSAnalytics vision documentation

Summary

  • Added a new page for the ENSAnalytics

Why

  • This was discussed during the call.

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)

@Goader Goader requested a review from lightwalker-eth May 19, 2026 17:01
@Goader Goader self-assigned this May 19, 2026
@Goader Goader requested a review from a team as a code owner May 19, 2026 17:01
Copilot AI review requested due to automatic review settings May 19, 2026 17:01
@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)
admin.ensnode.io Ready Ready Preview, Comment May 19, 2026 5:09pm
enskit-react-example.ensnode.io Ready Ready Preview, Comment May 19, 2026 5:09pm
ensnode.io Ready Ready Preview, Comment May 19, 2026 5:09pm
ensrainbow.io Ready Ready Preview, Comment May 19, 2026 5:09pm

@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented May 19, 2026

⚠️ No Changeset found

Latest commit: c8c0386

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

Review Change Stack

Warning

Rate limit exceeded

@Goader has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 54 minutes and 5 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, 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 have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 454eb86d-6985-4435-9c3f-8bb0742bd4a7

📥 Commits

Reviewing files that changed from the base of the PR and between f040352 and c8c0386.

📒 Files selected for processing (3)
  • docs/ensnode.io/config/integrations/starlight/sidebar-topics/services.ts
  • docs/ensnode.io/src/content/docs/docs/services/ensanalytics/index.mdx
  • docs/ensnode.io/src/content/docs/docs/services/index.mdx
📝 Walkthrough

Walkthrough

This PR adds complete documentation and navigation integration for the ENSAnalytics service across the ENSNode docs site. The changes introduce an ENSAnalytics documentation page describing its vision, use cases, and relationship to ENSDb, wire it into the sidebar navigation system, and expose it as a card on the services overview page.

Changes

ENSAnalytics Documentation Integration

Layer / File(s) Summary
ENSAnalytics documentation and navigation wiring
docs/ensnode.io/src/content/docs/docs/services/index.mdx, docs/ensnode.io/src/content/docs/docs/services/ensanalytics/index.mdx, docs/ensnode.io/config/integrations/starlight/sidebar-topics/services.ts
Services overview page adds an ENSAnalytics card; new ENSAnalytics documentation page describes product vision, policy levers, custom dashboards, and the ENS Referral Program as the first analytics product; sidebar navigation adds a collapsed ENSAnalytics section with an Overview link.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Possibly related PRs

  • namehash/ensnode#2107: Extends the same servicesSidebarTopic items list with a top-level service section by adding ENSEngine documentation.

Poem

🐰 A new analytics path appears,
ENSAnalytics soars through the docs,
Sidebar navigation steers visitors clear,
Policy levers and cohorts unlock,
The service graph grows, no fears!

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description is largely incomplete. It omits the 'Testing' section entirely and provides minimal details in the 'Why' section (only 'This was discussed during the call' without context or issue links). Add a 'Testing' section explaining how the documentation was verified, and expand the 'Why' section with specific context or related GitHub issue links.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title 'docs: ENSAnalytics' directly and clearly summarizes the main change: adding documentation for ENSAnalytics.
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/ensanalytics

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 new vision/overview documentation page for ENSAnalytics, a planned analytics engine on top of ENSDb, and wires it into the services sidebar and services index.

Changes:

  • New ensanalytics/index.mdx overview page describing the vision, use cases, and how it fits with ENSDb/ENSApi.
  • Adds an ENSAnalytics entry to the services landing CardGrid.
  • Adds an ENSAnalytics section to the services sidebar topic.

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/services/index.mdx Adds LinkCard for ENSAnalytics on the services overview page.
docs/ensnode.io/src/content/docs/docs/services/ensanalytics/index.mdx New vision/overview page for ENSAnalytics.
docs/ensnode.io/config/integrations/starlight/sidebar-topics/services.ts Registers the new ENSAnalytics overview in the services sidebar.

💡 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 new ENSAnalytics documentation page that frames the service as a future vision built on top of ENSDb, with the ENS Referral Program cited as the first live slice. The services overview index and the Starlight sidebar are both updated to include the new entry.

  • ensanalytics/index.mdx — new page covering planned cohort analysis, policy-impact dashboards, and custom operator views; clearly scoped as a vision with an Aside callout and accurate "planned" language throughout.
  • services/index.mdx — adds an ENSAnalytics card to the overview grid (at the end alongside ENSEngine) and updates the frontmatter description to enumerate it.
  • services.ts — adds the ENSAnalytics sidebar entry after ENSApi, which is earlier than its position in the card grid.

Confidence Score: 5/5

Documentation-only change with no code logic; safe to merge.

All three files are purely prose and sidebar configuration. The new ENSAnalytics page correctly frames the service as a future vision, previously flagged issues (stale description, misleading LinkCard copy) have been addressed, and no functional code is touched.

No files require special attention.

Important Files Changed

Filename Overview
docs/ensnode.io/src/content/docs/docs/services/ensanalytics/index.mdx New ENSAnalytics vision page; clearly frames the service as future/planned with an Aside callout, and links to the live ENS Referral Program as a first concrete slice.
docs/ensnode.io/src/content/docs/docs/services/index.mdx Adds ENSAnalytics card to the services overview grid and updates the frontmatter description to include it.
docs/ensnode.io/config/integrations/starlight/sidebar-topics/services.ts Adds ENSAnalytics sidebar entry after ENSApi; placement is earlier than the card-grid order on the overview page.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    Chain["Onchain ENS Events"] --> ENSIndexer["ENSIndexer\n(multichain indexer)"]
    ENSIndexer --> ENSDb["ENSDb\n(live ENS state)"]
    ENSDb --> ENSApi["ENSApi\n(name resolution APIs)"]
    ENSDb --> ENSAnalytics["ENSAnalytics ✦ vision\n(cohorts · policy impact · dashboards)"]
    ENSAnalytics --> ENSAwards["ENSAwards / Referral Program\n(first live slice today)"]
    ENSAnalytics --> Operators["Operator dashboards\n(registrars, ENS DAO, app builders)"]

    style ENSAnalytics stroke-dasharray: 5 5
Loading

Reviews (3): Last reviewed commit: "Merge remote-tracking branch 'origin' in..." | Re-trigger Greptile

Comment thread docs/ensnode.io/src/content/docs/docs/services/ensanalytics/index.mdx Outdated
@Goader
Copy link
Copy Markdown
Member Author

Goader commented May 19, 2026

@greptile

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.

@Goader Good to see this! Sharing some initial partial feedback. Lots of additional advice to share -- please setup a call and let's sync 👍

],
},
{
label: "ENSAnalytics",
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Please move ENSAnalytics to the bottom of the list for now 👍

<img slot="icon" src={ENSRainbow3DImage.src} alt="" aria-hidden="true" class="scale-175 w-[125px] sm:w-[150px] lg:w-[175px] h-auto aspect-square max-sm:overflow-hidden" />
</ENSNodeServiceCard>

<ENSNodeServiceCard title="ENSAnalytics" href="/docs/services/ensanalytics" description="Our vision for an analytics engine on ENS — cohorts, behavior, and policy insights on top of ENSDb." />
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
<ENSNodeServiceCard title="ENSAnalytics" href="/docs/services/ensanalytics" description="Our vision for an analytics engine on ENS — cohorts, behavior, and policy insights on top of ENSDb." />
<ENSNodeServiceCard title="ENSAnalytics" href="/docs/services/ensanalytics" description="Unlock strong data-based decision making in the ENS DAO about what's really driving ENS growth and engagement — cohorts, behavior, and policy insights on top of ENSDb." />

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.

3 participants