docs: fix grammatical errors and terminology inconsistencies#5893
docs: fix grammatical errors and terminology inconsistencies#5893chenjiahan merged 3 commits intomainfrom
Conversation
|
|
✅ Deploy Preview for rsbuild ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Co-authored-by: chenjiahan <7237365+chenjiahan@users.noreply.github.com>
Co-authored-by: chenjiahan <7237365+chenjiahan@users.noreply.github.com>
There was a problem hiding this comment.
Pull Request Overview
This PR improves the overall quality and consistency of Rsbuild documentation by addressing grammatical errors, awkward phrasing, and terminology inconsistencies across multiple documentation files. The changes focus on enhancing readability and maintaining professional technical writing standards.
- Standardized terminology from informal "configs" to proper "configurations" or "configuration options"
- Fixed grammatical issues and improved sentence flow throughout documentation
- Applied consistent phrasing improvements across both English and Chinese documentation
Reviewed Changes
Copilot reviewed 10 out of 10 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
website/docs/zh/config/source/define.mdx |
Fixed comment phrasing from "Turn into being..." to "Turns into" |
website/docs/en/guide/start/index.mdx |
Updated "build configs" to "build configurations" for consistency |
website/docs/en/guide/debug/debug-mode.mdx |
Removed unnecessary article "the" and improved terminology |
website/docs/en/guide/basic/server.mdx |
Standardized "configs" to "configurations" and "configuration options" |
website/docs/en/guide/basic/output-files.mdx |
Updated terminology and improved list introduction formatting |
website/docs/en/guide/basic/html-template.mdx |
Changed "configs" to "configuration options" for consistency |
website/docs/en/guide/basic/cli.mdx |
Updated CLI help text to use "configurations" instead of "configs" |
website/docs/en/guide/advanced/environments.mdx |
Applied consistent terminology throughout environment documentation |
website/docs/en/config/source/define.mdx |
Fixed comment phrasing to match Chinese documentation |
website/docs/en/api/start/index.mdx |
Updated terminology to use "configurations" for consistency |

This PR fixes various documentation errors found across the website/docs directory, including grammatical issues, awkward phrasing, and terminology inconsistencies.
Changes Made
Grammar and Phrasing Improvements
Terminology Consistency
Files Modified
website/docs/en/config/source/define.mdx- Fixed code comment phrasingwebsite/docs/en/guide/debug/debug-mode.mdx- Removed unnecessary articles and improved grammarwebsite/docs/en/guide/basic/html-template.mdx- Updated terminology for consistencywebsite/docs/en/guide/basic/output-files.mdx- Improved list formatting and terminologywebsite/docs/en/guide/basic/server.mdx- Enhanced grammar and consistencywebsite/docs/en/guide/basic/cli.mdx- Standardized terminologywebsite/docs/en/guide/advanced/environments.mdx- Fixed grammar and terminologywebsite/docs/en/api/start/index.mdx- Improved terminology consistencywebsite/docs/en/guide/start/index.mdx- Enhanced introduction claritywebsite/docs/zh/config/source/define.mdx- Applied same phrasing fixes to Chinese docsAll changes maintain the original meaning while improving readability and maintaining consistency with professional technical writing standards. The modifications passed all linting and spell-checking requirements.
✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.