Skip to content

docs: improve readability by fixing grammar and formatting code blocks#8710

Open
Venkat-Entropik wants to merge 2 commits intonodejs:mainfrom
Venkat-Entropik:docs/improve-documentation-readability
Open

docs: improve readability by fixing grammar and formatting code blocks#8710
Venkat-Entropik wants to merge 2 commits intonodejs:mainfrom
Venkat-Entropik:docs/improve-documentation-readability

Conversation

@Venkat-Entropik
Copy link

Description

This PR improves documentation readability by correcting grammar, refining wording, and formatting command examples in code blocks.

Some sentences were simplified to make the documentation clearer and more consistent.

Examples of improvements:

Before:
"Nodejs.org by the OpenJS Foundation is the official website..."

After:
"Nodejs.org, maintained by the OpenJS Foundation, is the official website..."

Before:
"Any person who wants to contribute to the Website is welcome!"

After:
"Anyone who wants to contribute to the website is welcome."

Additionally, command examples are now properly formatted inside code blocks:

pnpm install --frozen-lockfile
pnpm dev

These updates improve readability and maintain consistency across the documentation.


Validation

  • Verified that the documentation renders correctly with the updated wording.
  • Confirmed that command examples display properly inside code blocks.
  • Ran the following commands locally to ensure the project builds correctly:
pnpm install
pnpm format
pnpm test
pnpm build

Related Issues

Fixes #8704


Check List

  • I have read the Contributing Guidelines and made commit messages that follow the guideline.
  • I have run pnpm format to ensure the code follows the style guide.
  • I have run pnpm test to check if all tests are passing.
  • I have run pnpm build to check if the website builds without errors.
  • I've covered new added functionality with unit tests if necessary.

@Venkat-Entropik Venkat-Entropik requested a review from a team as a code owner March 10, 2026 04:14
@vercel
Copy link

vercel bot commented Mar 10, 2026

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

Project Deployment Actions Updated (UTC)
nodejs-org Ready Ready Preview Mar 10, 2026 0:42am

Request Review

@github-actions
Copy link
Contributor

👋 Codeowner Review Request

The following codeowners have been identified for the changed files:

Team reviewers: @nodejs/nodejs-website

Please review the changes when you have a chance. Thank you! 🙏

pnpm dev

# listening at localhost:3000
# Listening at http://localhost:3000
Copy link
Member

Choose a reason for hiding this comment

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

What's wrong with the previous comment?

Copy link
Author

Choose a reason for hiding this comment

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

Thanks for pointing that out.

I updated the comment to improve consistency and clarity by capitalizing the sentence and explicitly including the http:// protocol.

However, the original comment also works fine. I'm happy to revert the change if you prefer keeping the previous wording.

README.md Outdated
This project adopts the Node.js [Code of Conduct][].

Any person who wants to contribute to the Website is welcome! Please read [Contribution Guidelines][] and see the [Figma Design][] to understand better the structure of this repository.
Anyone who wants to contribute to the website is welcome. Please read [Contribution Guidelines][] and see the [Figma Design][] to understand better the structure of this repository.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Anyone who wants to contribute to the website is welcome. Please read [Contribution Guidelines][] and see the [Figma Design][] to understand better the structure of this repository.
Anyone who wants to contribute to the website is welcome! Please read [Contribution Guidelines][] and see the [Figma Design][] to understand better the structure of this repository.

Copy link
Author

Choose a reason for hiding this comment

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

Thanks for the suggestion! I've updated the sentence to keep the exclamation mark.

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.

Grammar and formatting issues in README documentation

3 participants