Skip to content

docs: update docs#2005

Open
sevenzing wants to merge 2 commits intoll/docker-v2from
ll/docs
Open

docs: update docs#2005
sevenzing wants to merge 2 commits intoll/docker-v2from
ll/docs

Conversation

@sevenzing
Copy link
Copy Markdown
Member

Summary

  • Migrated Docker documentation strategy to docs-site-first: simplified docker/README.md, expanded deploying/docker.mdx, and aligned contributor docs for detached compose usage.
  • Reworked quickstart/usage docs navigation: reshaped docs/index.mdx into use-case paths, added placeholder pages for enssdk, enskit, and Omnigraph API, and reordered usage sidebar pages.

Testing

  • Run pnpm docs:dev and checked everything is correct.

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)

@sevenzing sevenzing requested a review from a team as a code owner April 28, 2026 14:25
@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented Apr 28, 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 Apr 28, 2026 3:45pm
ensnode.io Ready Ready Preview, Comment Apr 28, 2026 3:45pm
ensrainbow.io Ready Ready Preview, Comment Apr 28, 2026 3:45pm

@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented Apr 28, 2026

⚠️ No Changeset found

Latest commit: 219a475

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

@sevenzing sevenzing changed the base branch from main to ll/docker-v2 April 28, 2026 14:25
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 28, 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: b3ae5787-400d-4255-9129-c94b8d9d0325

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
📝 Walkthrough

Walkthrough

The PR refactors Docker infrastructure by renaming the postgres service to ensdb across all compose configurations, introduces version pinning via ENSNODE_TAG environment variable for service image tags, reorganizes documentation with a new quickstart navigation hub covering multiple integration paths, and updates release automation with renamed scripts and a new release:postversion post-version hook for Docker tag synchronization and OpenAPI generation.

Changes

Cohort / File(s) Summary
Release Workflow Scripts
.github/workflows/release.yml, .github/workflows/release_snapshot.yml
Updated publish command invocation from changeset-publish to changeset:publish (with :next variant); added chained versioning with release:postversion hook to root workflow.
Package Versioning
apps/ensapi/package.json, docker/envs/.env.docker.common
Bumped ensapi package version to 1.10.2; added ENSNODE_TAG=1.9.0 environment variable.
Docker Compose Infrastructure
docker/docker-compose.yml, docker/docker-compose.devnet.yml, docker/docker-compose.orchestrator.yml
Renamed postgres service to ensdb, updated service dependencies, renamed postgres_data volume to ensdb_data across all compose files; removed service-specific environment overrides from devnet stack.
Docker Service Definitions
docker/services/ensdb.yml, docker/services/ensapi.yml, docker/services/ensindexer.yml, docker/services/ensadmin.yml, docker/services/ensrainbow.yml
Renamed service container from postgres to ensdb; parameterized image tags from :latest to ${ENSNODE_TAG:-<version>} for versioned services.
Docker Environment Configuration
docker/envs/.env.docker.common, docker/envs/.env.docker.devnet
Updated database host from postgres to ensdb in connection URL; added ENSIndexer namespace, schema, RPC configuration, and ENSRainbow label set ID to devnet environment.
Docker README & Contributing Docs
docker/README.md, docs/ensnode.io/src/content/docs/docs/contributing/index.mdx
Replaced detailed Docker Compose documentation with links to external Quickstart Guide; updated stopping instructions for detached stacks.
Root Documentation Hub & Quickstart
README.md, docs/ensnode.io/src/content/docs/docs/index.mdx
Replaced Docker-focused instructions with "Quickstart" section linking to ENSNode Quickstart Guide; restructured homepage with multiple integration path options (Omnigraph API, enssdk, ensjs, enskit, viem/chain).
Usage Documentation Pages
docs/ensnode.io/src/content/docs/docs/usage/omnigraph-api.mdx, docs/ensnode.io/src/content/docs/docs/usage/with-enssdk.mdx, docs/ensnode.io/src/content/docs/docs/usage/with-enskit.mdx, docs/ensnode.io/src/content/docs/docs/usage/with-viem.mdx, docs/ensnode.io/src/content/docs/docs/usage/with-ensjs.mdx, docs/ensnode.io/src/content/docs/docs/usage/api.mdx
Added three new documentation pages (omnigraph-api, enssdk, enskit with TBD placeholders); reordered sidebar navigation for existing usage pages.
Docker Deployment Documentation
docs/ensnode.io/src/content/docs/docs/deploying/docker.mdx
Enhanced Docker setup guidance with resolved config inspection workflow, updated service naming to ensdb (postgres), added integration test orchestrator reference, expanded devnet examples with selective service startup and explicit stop commands.
Release Automation & Scripts
package.json, scripts/sync-docker-services-tags.mjs
Renamed changeset-publish* scripts to changeset:publish*; decoupled OpenAPI generation from versioning; added release:postversion hook and docker:tag:sync script for updating service tag defaults; introduced new sync-docker-services-tags.mjs script to validate and update ENSNODE_TAG defaults in Docker service files.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~22 minutes

Possibly related PRs

Poem

🐰 The rabbit hops through Docker's door,
Where postgres becomes ensdb forevermore,
With tags that sync and docs that guide,
The quickstart paths now open wide! 🌟

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (1 warning, 1 inconclusive)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
Title check ❓ Inconclusive The title is vague and overly generic, using a non-descriptive term 'update docs' that doesn't clearly convey the specific nature or scope of documentation changes. Revise the title to be more specific and descriptive, such as 'docs: migrate Docker docs to docs-site-first approach' or 'docs: restructure quickstart and Docker documentation.'
✅ Passed checks (3 passed)
Check name Status Explanation
Description check ✅ Passed The description mostly follows the template with all required sections present (Summary, Why/Testing, Pre-Review Checklist), though the Summary bullets adequately describe the changes made and testing is documented.
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 ll/docs

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.

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented Apr 28, 2026

Greptile Summary

This PR migrates Docker documentation to a docs-site-first strategy: docker/README.md is simplified to a pointer, deploying/docker.mdx is expanded with ENSNODE_TAG override patterns and full command references, and docs/index.mdx is reshaped into six use-case quickstart paths. Three new sidebar pages (omnigraph-api, with-enssdk, with-enskit) are stub placeholders; the prior review thread has already flagged those. The main substantive concern is the docker/.env auto-pickup claim in docker.mdx — when commands are run from the monorepo root as documented, Compose resolves .env relative to the working directory (repo root), not docker/, so the persistent override example may silently have no effect for users following the page's own instructions.

Confidence Score: 5/5

Safe to merge; all changes are documentation with no runtime impact

No P0 or P1 issues. The only notable finding is a potential documentation inaccuracy around Docker Compose .env resolution path (P2), and the three TBD stub pages were already addressed in the prior review thread. No code logic or runtime behavior is affected by this PR.

docs/ensnode.io/src/content/docs/docs/deploying/docker.mdx — the docker/.env auto-pickup claim on line 44 should be verified against actual Docker Compose V2 project-directory resolution behavior

Important Files Changed

Filename Overview
docs/ensnode.io/src/content/docs/docs/deploying/docker.mdx Significantly expanded with ENSNODE_TAG override patterns, full mainnet/devnet command sets, and inline stop commands; one minor concern around the docker/.env auto-pickup claim
docs/ensnode.io/src/content/docs/docs/index.mdx Reshaped into use-case quickstart paths with six LinkCards; viem code snippet removed and moved to dedicated page; clean restructure
docker/README.md Reduced from full command reference to a brief pointer to the docs site — intentional docs-site-first migration
README.md Replaced Running with Docker section with a prose quickstart link pointing to ensnode.io/docs
docs/ensnode.io/src/content/docs/docs/usage/omnigraph-api.mdx New placeholder stub page (TBD) for Omnigraph API; addressed in prior review thread
docs/ensnode.io/src/content/docs/docs/usage/with-enssdk.mdx New placeholder stub page (TBD) for enssdk integration; sidebar order 3
docs/ensnode.io/src/content/docs/docs/usage/with-enskit.mdx New placeholder stub page (TBD) for enskit integration; sidebar order 5
package.json Added docs:dev script using -F @docs/ensnode which correctly matches the package name in docs/ensnode.io/package.json
docs/ensnode.io/src/content/docs/docs/contributing/index.mdx Minor wording update: stop instructions now say detached Docker Compose stacks to match the -d usage pattern
docs/ensnode.io/src/content/docs/docs/usage/with-ensjs.mdx Sidebar order updated from 1 to 4 to accommodate new pages added before it
docs/ensnode.io/src/content/docs/docs/usage/with-viem.mdx Sidebar order updated from 4 to 6; no content changes
docs/ensnode.io/src/content/docs/docs/usage/api.mdx Sidebar order updated from 3 to 7; no content changes

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[User lands on ENSNode Docs] --> B{Choose quickstart path}
    B --> C[Quickly test ENSNode data]
    B --> D[Integrate with Omnigraph API]
    B --> E[Integrate with enssdk]
    B --> F[Integrate with ensjs]
    B --> G[Integrate with enskit]
    B --> H[Integrate via viem/chain]
    B --> I[Run your own ENSNode]

    C --> C1[Hosted ENSNode Instances]
    D --> D1[omnigraph-api.mdx TBD]
    E --> E1[with-enssdk.mdx TBD]
    F --> F1[with-ensjs.mdx]
    G --> G1[with-enskit.mdx TBD]
    H --> H1[with-viem.mdx]
    I --> I1[deploying/docker.mdx]
Loading

Reviews (3): Last reviewed commit: "add ENSNODE_TAG to docs" | Re-trigger Greptile

Comment on lines +7 to +8

TBD
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

P2 Three linked quickstart paths land on "TBD" stub pages

The index page now prominently routes users to omnigraph-api, with-enssdk, and with-enskit as primary quickstart paths, but all three pages contain only TBD. Consider adding an :::caution[Coming Soon] admonition or similar Starlight callout so users understand the content is in progress rather than encountering a blank page. The same applies to with-enssdk.mdx and with-enskit.mdx.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

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.

should probably remove this page rather than leave stubbed, unless planning on fast-following with content

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.

likewise for others

Copy link
Copy Markdown
Contributor

@vercel vercel Bot left a comment

Choose a reason for hiding this comment

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

Additional Suggestion:

Version mismatch in Docker Compose setup: .env.docker.common had outdated ENSNODE_TAG=1.9.0 while package.json was at 1.10.2

Fix on Vercel

Comment on lines +7 to +8

TBD
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.

should probably remove this page rather than leave stubbed, unless planning on fast-following with content

Comment on lines +7 to +8

TBD
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.

likewise for others

Comment thread package.json
"generate:openapi": "pnpm -r --if-present generate:openapi",
"generate:gqlschema": "pnpm -F ensapi generate:gqlschema && pnpm -F enssdk generate:gqlschema"
"generate:gqlschema": "pnpm -F ensapi generate:gqlschema && pnpm -F enssdk generate:gqlschema",
"docs:dev": "pnpm -F @docs/ensnode dev"
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.

hmm, we don't have any other shorthands for subproject dev scripts in the monorepo root; i see that it's more convenient but then i'd prefer to have all or none, wdyt?

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