Skip to content

Comments

docs: improve server options description for clarity#7067

Merged
chenjiahan merged 1 commit intomainfrom
server_option_doc_0128
Jan 28, 2026
Merged

docs: improve server options description for clarity#7067
chenjiahan merged 1 commit intomainfrom
server_option_doc_0128

Conversation

@chenjiahan
Copy link
Member

Summary

Updated the documentation to clarify that server options are mainly for local development and preview, but some options (such as publicDir and base) also affect production builds.

Checklist

  • Tests updated (or not required).
  • Documentation updated (or not required).

Copilot AI review requested due to automatic review settings January 28, 2026 03:02
@chatgpt-codex-connector
Copy link

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @chenjiahan, 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 enhances the clarity of the server configuration options within Rsbuild's documentation. The changes aim to provide a more precise understanding of when these options apply, distinguishing their primary role in local development and preview environments from their occasional impact on production builds, thereby preventing potential misinterpretations for developers.

Highlights

  • Documentation Clarity: Updated the description for server options in Rsbuild to clearly state they are primarily for local development and preview.
  • Production Impact: Added a note that certain server options, such as publicDir and base, also influence production builds.
  • Multilingual Docs: Applied these documentation improvements to both English and Chinese configuration guides, as well as the core TypeScript type definition.
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 by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

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 pull request 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
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 improves the documentation for the server configuration option by clarifying that while it's mainly for development and preview, some of its properties also impact production builds. The changes are applied consistently across the TypeScript type definitions and the English and Chinese documentation files.

My review includes a couple of minor suggestions to improve the readability of the code examples in the documentation by wrapping code identifiers in backticks.

Copy link
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

This PR updates documentation to clarify that server configuration options primarily apply to local development and preview, but notes that some options like publicDir and base also affect production builds.

Changes:

  • Updated English documentation in the configuration guide to clarify server options scope
  • Updated Chinese documentation in the configuration guide with the same clarification
  • Updated TypeScript JSDoc comments for the server config property in the type definitions

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File Description
website/docs/en/guide/configuration/rsbuild.mdx Updated English documentation comment to clarify that server options mainly apply to development/preview, with some exceptions for production
website/docs/zh/guide/configuration/rsbuild.mdx Updated Chinese documentation comment with the same clarification for consistency
packages/core/src/types/config.ts Updated JSDoc comment for the server config property to accurately reflect its usage scope

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@cloudflare-workers-and-pages
Copy link

Deploying rsbuild with  Cloudflare Pages  Cloudflare Pages

Latest commit: 03b86ff
Status: ✅  Deploy successful!
Preview URL: https://99aaa7f4.rsbuild-v2.pages.dev
Branch Preview URL: https://server-option-doc-0128.rsbuild-v2.pages.dev

View logs

@chenjiahan chenjiahan merged commit b939ce8 into main Jan 28, 2026
13 checks passed
@chenjiahan chenjiahan deleted the server_option_doc_0128 branch January 28, 2026 03:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant