Skip to content

chore(docs): delete the in-app /docs subroute (use the official docs codebase)#1835

Merged
sweetmantech merged 1 commit into
mainfrom
chore/delete-in-app-docs
Jul 1, 2026
Merged

chore(docs): delete the in-app /docs subroute (use the official docs codebase)#1835
sweetmantech merged 1 commit into
mainfrom
chore/delete-in-app-docs

Conversation

@sweetmantech

@sweetmantech sweetmantech commented Jul 1, 2026

Copy link
Copy Markdown
Collaborator

Part of #1833 — flagged on chat#1834.

Why

app/docs/ (the /docs/{account,posts,fans,base} pages + their constants.ts) is a hand-maintained copy of the API docs that duplicates and drifts from the official docs codebase (docs.recoupable.dev, the OpenAPI we reconcile against). chat#1834 had to hand-edit socials[].idsocial_id in app/docs/account/constants.ts, and cubic immediately flagged the exampleResponse/TS-interface still showing id — the exact drift a second docs source causes. Documentation lives in the official docs codebase, not this subroute.

Change

  • Delete app/docs/ (8 files — 4 pages + constants).
  • Delete components/docs/ (5 files — CodeBlock, LanguageSelector, ResponseTable, AuthSection, ViewAgentSection) — used only by those pages.

Verified: nothing outside app/docs/ imports these; no Link/href to the /docs route anywhere; tsc shows no docs-related dangling imports. 13 files removed, no other code touched.

🤖 Generated with Claude Code


Summary by cubic

Remove the in-app /docs route and doc-only components to stop duplicating the official docs and prevent drift. Aligns with recoupable/chat#1833 and fixes drift flagged in chat#1834.

  • Refactors
    • Deleted app/docs/* (/docs/{account,posts,fans,base}) and components/docs/* used only by those pages.
    • Verified no /docs links/imports and no dangling types (tsc clean).
    • Official docs live at https://docs.recoupable.dev (OpenAPI source of truth).

Written for commit 636cda6. Summary will update on new commits.

Review in cubic

…codebase)

app/docs/ (account/posts/fans/base pages + their constants) is a hand-maintained
copy of the API docs that duplicates and drifts from the official docs codebase
(docs.recoupable.dev). chat#1834 had to hand-edit socials[].id -> social_id there
and cubic immediately flagged the example/TS-interface still showing id — exactly
the drift a second docs source causes.

Delete app/docs/ and its now-dead-only support components (components/docs/*, used
solely by these pages). No links to the /docs route exist. Documentation lives in
the official docs codebase.

Part of #1833.

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

vercel Bot commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

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

Project Deployment Actions Updated (UTC)
chat Ready Ready Preview Jul 1, 2026 10:44pm

Request Review

@coderabbitai

coderabbitai Bot commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

Warning

Review limit reached

@sweetmantech, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 17 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

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.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: a0a1f3d6-6f98-422f-ab14-d6bc9ff72c6f

📥 Commits

Reviewing files that changed from the base of the PR and between 56b6223 and 636cda6.

📒 Files selected for processing (13)
  • app/docs/account/constants.ts
  • app/docs/account/page.tsx
  • app/docs/base/constants.ts
  • app/docs/base/page.tsx
  • app/docs/fans/constants.ts
  • app/docs/fans/page.tsx
  • app/docs/posts/constants.ts
  • app/docs/posts/page.tsx
  • components/docs/AuthSection.tsx
  • components/docs/CodeBlock.tsx
  • components/docs/LanguageSelector.tsx
  • components/docs/ResponseTable.tsx
  • components/docs/ViewAgentSection.tsx
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch chore/delete-in-app-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.

@cubic-dev-ai cubic-dev-ai 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.

No issues found across 13 files

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.

Auto-approved: Removes duplicate in-app docs pages and unused components. Verified no imports or links remain; no risk of breakage.

Re-trigger cubic

@chatgpt-codex-connector chatgpt-codex-connector 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.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 636cda66cc

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread app/docs/account/page.tsx
import { codeExamples, exampleResponse, responseProperties } from "./constants";
import { Language, languages } from "@/types/Docs";

export default function AccountDocs() {

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Add redirects for removed docs routes

When a previously published URL such as /docs/account is requested after this deletion (same for the sibling /docs/posts, /docs/fans, and /docs/base pages), Next has no matching page and I checked next.config.mjs/vercel.json contain no replacement redirect, so users with bookmarks or external links fall through to the app 404 instead of the official docs. Since this change explicitly moves docs to docs.recoupable.dev, please keep a thin route or config redirect for /docs/:path*.

Useful? React with 👍 / 👎.

@sweetmantech sweetmantech merged commit 26c8ff9 into main Jul 1, 2026
4 checks passed
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