Skip to content

docs: reorganize nav and sidebar#985

Merged
dinwwwh merged 2 commits intomainfrom
docs/reorganize-navsidebar
Sep 11, 2025
Merged

docs: reorganize nav and sidebar#985
dinwwwh merged 2 commits intomainfrom
docs/reorganize-navsidebar

Conversation

@dinwwwh
Copy link
Copy Markdown
Member

@dinwwwh dinwwwh commented Sep 10, 2025

Summary by CodeRabbit

  • Documentation
    • Top nav updated: removed “Examples”, added “Blog” (moved out of About).
    • Docs sidebar reorganized: added Comparison, Ecosystem, Playgrounds; moved Examples into a collapsible Integrations group with OpenAI Streaming at its new path; removed old Others and standalone Examples section.
    • OpenAPI/docs references consolidated to the new examples location.
    • Ecosystem tool description refreshed; OpenAI Streaming doc enhanced with client header and links.
    • Minor punctuation/readability edits across multiple pages.

@vercel
Copy link
Copy Markdown

vercel Bot commented Sep 10, 2025

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

Project Deployment Preview Comments Updated (UTC)
orpc Ready Ready Preview Comment Sep 11, 2025 1:09am

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Sep 10, 2025

Walkthrough

Reorganized the VitePress docs site navigation and sidebars: removed top-level Examples, promoted Blog, added /docs/{comparison,ecosystem,playgrounds}, nested Examples under Integrations with /docs/examples/openai-streaming, removed the old Others and standalone /examples/ sidebar; plus small punctuation/formatting edits and an Ecosystem entry update.

Changes

Cohort / File(s) Summary
VitePress docs site config
apps/content/.vitepress/config.ts
Reworked navigation and sidebars: removed top-level Examples, added /docs/comparison, /docs/ecosystem, /docs/playgrounds; created an Integrations → Examples group with /docs/examples/openai-streaming; removed the “Others” group and the standalone /examples/ sidebar.
Docs: punctuation/formatting tweaks
apps/content/docs/client/server-side.md, apps/content/docs/context.md, apps/content/docs/getting-started.md, apps/content/docs/event-iterator.md, apps/content/docs/integrations/tanstack-query-old/basic.md
Minor typographic edits (em dashes → commas, punctuation/formatting normalization); no functional or API changes.
Docs: Ecosystem entry update
apps/content/docs/ecosystem.md
Replaced “Drizzle oRPC Generator” entry with “DRZL”; updated description text; repository link unchanged.
Docs: Example page scaffolding
apps/content/docs/examples/openai-streaming.md
Inserted a CLIENT section header before the RPCLink instantiation and appended an info admonition linking to RPCLink and Event Iterator docs; content-only additions.

Sequence Diagram(s)

(omitted — changes are configuration and documentation edits without runtime control-flow modifications)

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

  • unnoq/orpc#555 — Modifies the same VitePress docs navigation/config (apps/content/.vitepress/config.ts) and likely overlaps with sidebar/nav changes.
  • unnoq/orpc#551 — Edits the OpenAI Streaming documentation content that was moved/updated here (apps/content/docs/examples/openai-streaming.md).
  • unnoq/orpc#391 — Also updates Ecosystem docs/sidebar placement, overlapping with the ecosystem exposure in this PR.

Suggested labels

size:XL

Pre-merge checks (3 passed)

✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title Check ✅ Passed The title "docs: reorganize nav and sidebar" accurately and concisely summarizes the PR’s primary change — restructuring the site navigation and sidebar (as reflected in apps/content/.vitepress/config.ts and related docs updates). It follows conventional scope prefixing, is a single clear sentence, and contains no irrelevant noise. A reviewer scanning history will understand the main intent from this title.
Docstring Coverage ✅ Passed No functions found in the changes. Docstring coverage check skipped.

Poem

I hopped through menus, neat and spry,
Moved Examples under a friendlier sky.
Comparison, Ecosystem, Playgrounds in sight,
Blog now shines as a top-level light.
Thump-thump — docs tidy, carrot bright! 🥕

Tip

👮 Agentic pre-merge checks are now available in preview!

Pro plan users can now enable pre-merge checks in their settings to enforce checklists before merging PRs.

  • Built-in checks – Quickly apply ready-made checks to enforce title conventions, require pull request descriptions that follow templates, validate linked issues for compliance, and more.
  • Custom agentic checks – Define your own rules using CodeRabbit’s advanced agentic capabilities to enforce organization-specific policies and workflows. For example, you can instruct CodeRabbit’s agent to verify that API documentation is updated whenever API schema files are modified in a PR. Note: Upto 5 custom checks are currently allowed during the preview period. Pricing for this feature will be announced in a few weeks.

Please see the documentation for more information.

Example:

reviews:
  pre_merge_checks:
    custom_checks:
      - name: "Undocumented Breaking Changes"
        mode: "warning"
        instructions: |
          Pass/fail criteria: All breaking changes to public APIs, CLI flags, environment variables, configuration keys, database schemas, or HTTP/GraphQL endpoints must be documented in the "Breaking Change" section of the PR description and in CHANGELOG.md. Exclude purely internal or private changes (e.g., code not exported from package entry points or explicitly marked as internal).

Please share your feedback with us on this Discord post.

✨ Finishing Touches
  • 📝 Generate Docstrings
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch docs/reorganize-navsidebar

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.

@dosubot dosubot Bot added the size:M This PR changes 30-99 lines, ignoring generated files. label Sep 10, 2025
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

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

Summary of Changes

Hello @unnoq, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request focuses on enhancing the user experience of the documentation by restructuring the navigation and sidebar. The changes aim to make content more intuitive to find by consolidating related sections and improving the overall flow of information, alongside minor textual refinements for clarity.

Highlights

  • Documentation Navigation Reorganization: The primary navigation bar has been streamlined by removing the direct 'Examples' link, and the sidebar structure has been significantly reorganized to improve content discoverability.
  • Examples Content Integration: All example documentation, specifically 'OpenAI Streaming', has been moved from a separate top-level section into a new, collapsible 'Examples' group within the main '/docs/' sidebar, and the corresponding file was relocated.
  • Sidebar Content Consolidation: Previously grouped items like 'Comparison', 'Ecosystem', and 'Playgrounds' have been elevated from a generic 'Others' section to direct entries within the main '/docs/' sidebar, enhancing their visibility.
  • Minor Textual and Punctuation Improvements: Several documentation files received minor edits to improve readability and correct punctuation, specifically changing em-dashes to commas for better flow.
  • Ecosystem Page Update: The 'Ecosystem' documentation page was updated to reflect a name change and new description for the Drizzle ORM generator entry.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point in your pull request via creating an issue comment (i.e. comment on the pull request page) using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in issue comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request effectively reorganizes the documentation's navigation and sidebar to improve discoverability. Key changes include moving the 'Examples' section into the 'Docs' sidebar and promoting several pages to top-level items. The implementation is consistent, with corresponding updates to configuration, file paths, and minor content enhancements. The changes are well-executed and improve the overall structure and readability of the documentation. I have no concerns with the proposed changes.

@codecov
Copy link
Copy Markdown

codecov Bot commented Sep 10, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@pkg-pr-new
Copy link
Copy Markdown

pkg-pr-new Bot commented Sep 10, 2025

More templates

@orpc/arktype

npm i https://pkg.pr.new/@orpc/arktype@985

@orpc/client

npm i https://pkg.pr.new/@orpc/client@985

@orpc/contract

npm i https://pkg.pr.new/@orpc/contract@985

@orpc/experimental-durable-event-iterator

npm i https://pkg.pr.new/@orpc/experimental-durable-event-iterator@985

@orpc/hey-api

npm i https://pkg.pr.new/@orpc/hey-api@985

@orpc/interop

npm i https://pkg.pr.new/@orpc/interop@985

@orpc/json-schema

npm i https://pkg.pr.new/@orpc/json-schema@985

@orpc/nest

npm i https://pkg.pr.new/@orpc/nest@985

@orpc/openapi

npm i https://pkg.pr.new/@orpc/openapi@985

@orpc/openapi-client

npm i https://pkg.pr.new/@orpc/openapi-client@985

@orpc/otel

npm i https://pkg.pr.new/@orpc/otel@985

@orpc/react

npm i https://pkg.pr.new/@orpc/react@985

@orpc/react-query

npm i https://pkg.pr.new/@orpc/react-query@985

@orpc/experimental-react-swr

npm i https://pkg.pr.new/@orpc/experimental-react-swr@985

@orpc/server

npm i https://pkg.pr.new/@orpc/server@985

@orpc/shared

npm i https://pkg.pr.new/@orpc/shared@985

@orpc/solid-query

npm i https://pkg.pr.new/@orpc/solid-query@985

@orpc/standard-server

npm i https://pkg.pr.new/@orpc/standard-server@985

@orpc/standard-server-aws-lambda

npm i https://pkg.pr.new/@orpc/standard-server-aws-lambda@985

@orpc/standard-server-fetch

npm i https://pkg.pr.new/@orpc/standard-server-fetch@985

@orpc/standard-server-node

npm i https://pkg.pr.new/@orpc/standard-server-node@985

@orpc/standard-server-peer

npm i https://pkg.pr.new/@orpc/standard-server-peer@985

@orpc/svelte-query

npm i https://pkg.pr.new/@orpc/svelte-query@985

@orpc/tanstack-query

npm i https://pkg.pr.new/@orpc/tanstack-query@985

@orpc/trpc

npm i https://pkg.pr.new/@orpc/trpc@985

@orpc/valibot

npm i https://pkg.pr.new/@orpc/valibot@985

@orpc/vue-colada

npm i https://pkg.pr.new/@orpc/vue-colada@985

@orpc/vue-query

npm i https://pkg.pr.new/@orpc/vue-query@985

@orpc/zod

npm i https://pkg.pr.new/@orpc/zod@985

commit: 9a767d1

@dinwwwh dinwwwh added the lgtm This PR has been approved by a maintainer label Sep 10, 2025
Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

🧹 Nitpick comments (4)
apps/content/docs/examples/openai-streaming.md (1)

36-37: Add a matching "SERVER" delimiter for symmetry.

You added a clear CLIENT divider. Consider adding a matching SERVER divider above the server snippet to help readers scan the code.

Example:

// --------------- SERVER ---------------
const complete = os
  .input(z.object({ content: z.string() }))
  .handler(async function* ({ input }) { /* ... */ })
apps/content/docs/integrations/tanstack-query-old/basic.md (1)

85-87: Polish: container syntax + wording.

  • Prefer the VitePress container form with a space: ::: info.
  • Slight grammar tweak.
-:::info
-The `.key` accepts partial deep input, there's no need to supply full input.
+::: info
+The `.key` accepts a deep partial of the input; there's no need to supply the full input.
apps/content/docs/event-iterator.md (1)

8-8: LGTM — clearer lead sentence.

Reads better and sets context quickly. While here, consider fixing the front‑matter description (“Learn how to streaming…”) to “Learn how to stream…”.

apps/content/docs/client/server-side.md (1)

8-8: Rephrase for clarity.

A small grammar tweak improves flow.

-Call your [procedures](/docs/procedure) in the same environment as your server, no proxies required like native functions.
+Call your [procedures](/docs/procedure) in the same environment as your server—like native functions, with no proxies required.
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 1b94b3b and 8090f06.

📒 Files selected for processing (8)
  • apps/content/.vitepress/config.ts (3 hunks)
  • apps/content/docs/client/server-side.md (1 hunks)
  • apps/content/docs/context.md (1 hunks)
  • apps/content/docs/ecosystem.md (1 hunks)
  • apps/content/docs/event-iterator.md (1 hunks)
  • apps/content/docs/examples/openai-streaming.md (2 hunks)
  • apps/content/docs/getting-started.md (1 hunks)
  • apps/content/docs/integrations/tanstack-query-old/basic.md (1 hunks)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (3)
  • GitHub Check: lint
  • GitHub Check: test
  • GitHub Check: publish-commit
🔇 Additional comments (5)
apps/content/docs/examples/openai-streaming.md (1)

51-53: LGTM — useful cross-links.

The info box and links read well and are accurate.

apps/content/docs/getting-started.md (1)

10-10: LGTM — punctuation consistency.

Change improves readability and matches the style across docs.

apps/content/docs/context.md (1)

62-62: LGTM — punctuation fix.

Comma reads better than an em dash here.

apps/content/docs/ecosystem.md (1)

29-29: LGTM — DRZL entry update looks good.

Name, link, and description align with the new branding.

apps/content/.vitepress/config.ts (1)

86-99: Nav/sidebar restructure verified—no stale links or missing pages detected.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

🧹 Nitpick comments (1)
apps/content/.vitepress/config.ts (1)

72-72: Prefer linking Blog nav to the blog index for future-proofing.

Point the top-level Blog link to /blog/ instead of a specific post to avoid churn as new posts are added.

-      { text: 'Blog', link: '/blog/v1-announcement', activeMatch: '/blog/' },
+      { text: 'Blog', link: '/blog/', activeMatch: '/blog/' },
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 8090f06 and 9a767d1.

📒 Files selected for processing (1)
  • apps/content/.vitepress/config.ts (4 hunks)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (3)
  • GitHub Check: lint
  • GitHub Check: publish-commit
  • GitHub Check: test
🔇 Additional comments (3)
apps/content/.vitepress/config.ts (3)

86-86: OK — "Comparison" page exists.
apps/content/docs/comparison.md is present; no action required.


98-99: No action required — pages exist and no stale 'others' links remain.

apps/content/docs/ecosystem.md and apps/content/docs/playgrounds.md are present; inbound links updated in apps/content/index.md, apps/content/docs/integrations/opentelemetry.md, and apps/content/docs/advanced/publish-client-to-npm.md.


203-209: Add redirect and sweep old /examples/ links — new page exists, repo search inconclusive

  • apps/content/docs/examples/openai-streaming.md is present; apps/content/.vitepress/config.ts has no '/examples/' sidebar entry.
  • Add a redirect from /examples/openai-streaming → /docs/examples/openai-streaming (server rule on Netlify/Vercel or a small stub page at /examples/openai-streaming).
  • Sweep repo for remaining references; automated check here was inconclusive (ripgrep skipped files). Run locally: rg -n --hidden -uu '/examples/openai-streaming|examples/openai-streaming|/examples/' -g '!/node_modules/' and update any matches.

@dinwwwh dinwwwh merged commit 80c9415 into main Sep 11, 2025
11 checks passed
@coderabbitai coderabbitai Bot mentioned this pull request Sep 19, 2025
@coderabbitai coderabbitai Bot mentioned this pull request Apr 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

lgtm This PR has been approved by a maintainer size:M This PR changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant