Skip to content

docs: add dedicated Services section for infrastructure services#126

Closed
s-adamantine wants to merge 1 commit into
mainfrom
claude/busy-sinoussi
Closed

docs: add dedicated Services section for infrastructure services#126
s-adamantine wants to merge 1 commit into
mainfrom
claude/busy-sinoussi

Conversation

@s-adamantine

@s-adamantine s-adamantine commented Apr 16, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds a new Services nav section (between Tools and Architecture) for hosted infrastructure: Certified Services, Certified PDSs, and Hyperindex
  • Moves pages/tools/hyperindex.md, pages/reference/certified-services.md, and pages/reference/certified-pdss.md into pages/services/
  • Updates lib/navigation.js to reflect the new section and removes the moved entries from Tools and Reference
  • Updates all internal cross-references (14 files) to point to the new /services/ paths

Why

Service-related content was scattered across Tools, Reference, and Architecture sections. A dedicated Services section makes it easier to find infrastructure you interact with, and clarifies the distinction: Tools = things you install and run locally (CLI, Scaffold, Hyperboards), Services = hosted infrastructure (indexer, PDSs, service endpoints).

Test plan

  • npm run build passes with no errors
  • Verify sidebar renders the new Services section correctly
  • Spot-check internal links from Architecture and Getting Started pages

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Reorganized navigation structure to introduce a new "Services" section, consolidating Hyperindex, Certified Services, and Certified PDSs under one category for improved discoverability.
    • Updated internal documentation links across the site to reflect the new navigation hierarchy.

Move Hyperindex, Certified Services, and Certified PDSs into a new
"Services" nav section, separating hosted infrastructure from developer
tools. Update all internal cross-references to the new paths.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Apr 16, 2026

Copy link
Copy Markdown
Contributor

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

Project Deployment Actions Updated (UTC)
hypercerts-atproto-documentation Ready Ready Preview, Comment Apr 16, 2026 0:24am
hypercerts-v0.2-documentation Ready Ready Preview, Comment Apr 16, 2026 0:24am

@coderabbitai

coderabbitai Bot commented Apr 16, 2026

Copy link
Copy Markdown
📝 Walkthrough

Walkthrough

The PR reorganizes the documentation site's navigation structure by creating a new top-level Services section, moving Hyperindex from Tools and Certified PDSs/Services from Reference into the new section. All internal documentation links across multiple pages are updated to reflect the new paths accordingly.

Changes

Cohort / File(s) Summary
Navigation restructuring
lib/navigation.js
Removed Hyperindex from /tools, removed Certified PDSs and Certified Services from /reference, and created new top-level Services section containing these three entries at /services/.
Architecture documentation updates
pages/architecture/account-and-identity.md, pages/architecture/certified-group-service.md, pages/architecture/epds.md, pages/architecture/overview.md
Updated internal documentation links from /reference/certified-pdss to /services/certified-pdss and /tools/hyperindex to /services/hyperindex.
Core concepts and getting started updates
pages/core-concepts/why-at-protocol.md, pages/getting-started/testing-and-deployment.md
Updated Hyperindex and Certified PDSs references from old paths (/tools/hyperindex, /reference/certified-pdss) to new service paths (/services/hyperindex, /services/certified-pdss).
Reference and roadmap updates
pages/reference/faq.md, pages/reference/glossary.md, pages/roadmap.md
Updated multiple documentation links to point from /reference/certified-pdss and /tools/hyperindex to /services/certified-pdss and /services/hyperindex.
Services pages updates
pages/services/certified-pdss.md, pages/services/certified-services.md, pages/services/hyperindex.md
Updated cross-references between services pages to use new /services/ paths for Certified Services, Certified PDSs, and Hyperindex.
Tools documentation updates
pages/tools/scaffold.md
Updated environment variable documentation link from /reference/certified-pdss to /services/certified-pdss.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested reviewers

  • Kzoeps

Poem

🐰 A services garden springs to life so bright,
Where Hyperindex and Certified pages take flight,
From scattered reference shelves they now call,
A new Services section—unified for all! ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The PR title accurately and concisely describes the main change: adding a dedicated Services section to organize infrastructure services in the documentation navigation.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

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

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch claude/busy-sinoussi
⚔️ Resolve merge conflicts
  • Resolve merge conflict in branch claude/busy-sinoussi

Comment @coderabbitai help to get the list of available commands and usage tips.

@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: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@pages/architecture/epds.md`:
- Line 10: Update the link label in pages/architecture/epds.md so the anchor
text matches the target page title: change the phrase "Certified services" to
"Certified PDSs" for the link that points to /services/certified-pdss in the
sentence starting "Certified operates production, staging, and test ePDS
instances." This keeps the label consistent with the destination used later on
the 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: defaults

Review profile: CHILL

Plan: Pro

Run ID: 9951c6b7-52e0-4464-8255-6d8884e5b77a

📥 Commits

Reviewing files that changed from the base of the PR and between 0aae8c4 and bcb9140.

📒 Files selected for processing (14)
  • lib/navigation.js
  • pages/architecture/account-and-identity.md
  • pages/architecture/certified-group-service.md
  • pages/architecture/epds.md
  • pages/architecture/overview.md
  • pages/core-concepts/why-at-protocol.md
  • pages/getting-started/testing-and-deployment.md
  • pages/reference/faq.md
  • pages/reference/glossary.md
  • pages/roadmap.md
  • pages/services/certified-pdss.md
  • pages/services/certified-services.md
  • pages/services/hyperindex.md
  • pages/tools/scaffold.md

The ePDS adds email-based, passwordless sign-in on top of a standard AT Protocol PDS. Users enter their email, receive a one-time code, and end up with a normal AT Protocol session tied to a DID.

Certified operates production, staging, and test ePDS instances. See [Certified services](/reference/certified-pdss) for the current hostnames and guidance on which to use in which scenario.
Certified operates production, staging, and test ePDS instances. See [Certified services](/services/certified-pdss) for the current hostnames and guidance on which to use in which scenario.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Use consistent link label for the PDS page.

Line 10 links to /services/certified-pdss, but the label says “Certified services.” Consider matching the destination title (“Certified PDSs”) for consistency with Line 194.

✏️ Suggested copy tweak
-Certified operates production, staging, and test ePDS instances. See [Certified services](/services/certified-pdss) for the current hostnames and guidance on which to use in which scenario.
+Certified operates production, staging, and test ePDS instances. See [Certified PDSs](/services/certified-pdss) for the current hostnames and guidance on which to use in which scenario.
📝 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
Certified operates production, staging, and test ePDS instances. See [Certified services](/services/certified-pdss) for the current hostnames and guidance on which to use in which scenario.
Certified operates production, staging, and test ePDS instances. See [Certified PDSs](/services/certified-pdss) for the current hostnames and guidance on which to use in which scenario.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@pages/architecture/epds.md` at line 10, Update the link label in
pages/architecture/epds.md so the anchor text matches the target page title:
change the phrase "Certified services" to "Certified PDSs" for the link that
points to /services/certified-pdss in the sentence starting "Certified operates
production, staging, and test ePDS instances." This keeps the label consistent
with the destination used later on the 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