Skip to content

docs: fix errors, contractions, terminology, and grammar improvements#5889

Merged
chenjiahan merged 3 commits intomainfrom
copilot/fix-852d63e2-a823-49da-89d3-28d5b0f3671f
Aug 20, 2025
Merged

docs: fix errors, contractions, terminology, and grammar improvements#5889
chenjiahan merged 3 commits intomainfrom
copilot/fix-852d63e2-a823-49da-89d3-28d5b0f3671f

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Aug 20, 2025

This PR addresses various documentation errors found across the website/docs directory, including grammatical issues, contraction inconsistencies, and terminology standardization.

Changes Made

Contraction Standardization

Replaced informal contractions with formal language throughout the documentation to maintain consistency and professionalism:

  • it'sit is (5 instances)
  • don'tdo not (1 instance)

Terminology Consistency

Standardized proper noun capitalization:

  • webpackWebpack when referring to the tool name (not string literals)

Grammar and Clarity Improvements

  • Article usage: Added "section" to improve clarity in "The following shows..." → "The following section shows..."
  • Redundant words: Removed unnecessary articles in "for the detailed usage" → "for detailed usage"
  • Plural forms: Corrected "utility class" → "utility classes" for accuracy
  • Sentence structure: Improved parallel structure in compound sentences

Files Modified (9 total)

  • website/docs/en/api/javascript-api/instance.mdx
  • website/docs/en/config/html/tags.mdx
  • website/docs/en/config/performance/chunk-split.mdx
  • website/docs/en/config/security/sri.mdx
  • website/docs/en/config/source/define.mdx
  • website/docs/en/guide/basic/output-files.mdx
  • website/docs/en/guide/basic/static-deploy.mdx
  • website/docs/en/guide/styling/tailwindcss.mdx
  • website/docs/en/guide/styling/tailwindcss-v3.mdx

All changes are minimal and surgical, preserving the original meaning while improving readability and maintaining consistent documentation standards. The fixes passed spell check and formatting validation.


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

@netlify
Copy link
Copy Markdown

netlify bot commented Aug 20, 2025

Deploy Preview for rsbuild ready!

Name Link
🔨 Latest commit e7263dc
🔍 Latest deploy log https://app.netlify.com/projects/rsbuild/deploys/68a555db646d3400086ed8e6
😎 Deploy Preview https://deploy-preview-5889--rsbuild.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 72 (🔴 down 4 from production)
Accessibility: 97 (no change from production)
Best Practices: 100 (no change from production)
SEO: 100 (no change from production)
PWA: 60 (no change from production)
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@CLAassistant
Copy link
Copy Markdown

CLAassistant commented Aug 20, 2025

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
1 out of 2 committers have signed the CLA.

✅ chenjiahan
❌ Copilot
You have signed the CLA already but the status is still pending? Let us recheck it.

Co-authored-by: chenjiahan <7237365+chenjiahan@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix various documentation errors found across the website/docs directory, including typos, grammatical issues, and terminology inconsistencies. - Do not need to update the cpsell config. - Avoid making too many changes in a single PR; limit to less th... Fix documentation errors: contractions, terminology, and grammar improvements Aug 20, 2025
Copilot AI requested a review from chenjiahan August 20, 2025 04:52
@chenjiahan chenjiahan marked this pull request as ready for review August 20, 2025 04:58
Copilot AI review requested due to automatic review settings August 20, 2025 04:58
Copy link
Copy Markdown
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 standardizes documentation language by replacing contractions with formal language, correcting grammatical errors, and improving terminology consistency across the Rsbuild documentation. The changes focus on maintaining professional documentation standards while preserving clarity and meaning.

Key changes include:

  • Contraction standardization: replacing informal contractions like "it's", "don't" with formal equivalents
  • Grammar improvements: fixing plural forms, article usage, and sentence structure
  • Minor terminology corrections for consistency

Reviewed Changes

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

Show a summary per file
File Description
website/docs/en/api/javascript-api/instance.mdx Formal contraction replacement in note about method usage
website/docs/en/config/html/tags.mdx Grammar improvement in security warning about XSS
website/docs/en/config/performance/chunk-split.mdx Article removal and clarity improvement in reference text
website/docs/en/config/security/sri.mdx Contraction replacement in configuration description
website/docs/en/config/source/define.mdx Contraction replacement in bullet point
website/docs/en/guide/basic/output-files.mdx Added "section" for clarity in introductory text
website/docs/en/guide/basic/static-deploy.mdx Contraction replacement in GitHub Actions instruction
website/docs/en/guide/styling/tailwindcss.mdx Corrected plural form and parallel structure in description
website/docs/en/guide/styling/tailwindcss-v3.mdx Corrected plural form and parallel structure in description

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

@chenjiahan chenjiahan changed the title Fix documentation errors: contractions, terminology, and grammar improvements docs: fix documentation errors, contractions, terminology, and grammar improvements Aug 20, 2025
@chenjiahan chenjiahan changed the title docs: fix documentation errors, contractions, terminology, and grammar improvements docs: fix errors, contractions, terminology, and grammar improvements Aug 20, 2025
@chenjiahan chenjiahan merged commit 1d4b65c into main Aug 20, 2025
12 of 13 checks passed
@chenjiahan chenjiahan deleted the copilot/fix-852d63e2-a823-49da-89d3-28d5b0f3671f branch August 20, 2025 05:01
@chenjiahan chenjiahan mentioned this pull request Aug 21, 2025
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.

4 participants