Skip to content

docs: fix getting started UX issues from #7510#8119

Closed
KumarMunesh12 wants to merge 2 commits intowebpack:mainfrom
KumarMunesh12:docs/fix-issue-7510-getting-started-ux
Closed

docs: fix getting started UX issues from #7510#8119
KumarMunesh12 wants to merge 2 commits intowebpack:mainfrom
KumarMunesh12:docs/fix-issue-7510-getting-started-ux

Conversation

@KumarMunesh12
Copy link
Copy Markdown

Summary

Fixes several documentation UX issues reported in #7510 by a user
who walked through webpack.js.org from scratch and hit multiple
stumbling blocks as a first-time user.

Changes made

src/components/Splash/second/left.mdx

  • Added mode: "development" to the sample webpack.config.js
  • Without this, running the sample config from the front page
    produces a red warning: "mode option has not been set"
    confusing for new users following the getting started example

src/components/Splash/second/right.mdx

  • Reworded the video walkthrough line from:
    "Prefer a video walkthrough?"
    to:
    "Prefer a video walkthrough instead? See the ... guide."
  • The original phrasing made the video feel like the primary
    instruction rather than an optional alternative

src/content/index.mdx

  • Changed webpack to npx webpack in the run command
  • New users do not have webpack in their $PATH — npx webpack
    works out of the box without a global install

What was NOT changed

The css-loader page (webpack.js.org/loaders/css-loader/) also
has issues mentioned in #7510 — specifically:

  • import * as css from "file.css" should be import "./file.css"
    (bare path causes Can't resolve 'file.css' error)
  • webpack.config.js example needs // ... ellipsis lines
  • "You may need to install style-loader" should be "You must also
    install style-loader"

However, the css-loader docs live in the separate webpack/css-loader
repository (not in webpack.js.org), so those fixes will be submitted
as a separate PR to that repo.

Related

Closes #7510 (partial — items 2, 3, 4 from the original report)

Output

Screenshot from 2026-03-25 14-59-54

@vercel
Copy link
Copy Markdown

vercel bot commented Mar 25, 2026

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

Project Deployment Actions Updated (UTC)
webpack-js-org Ready Ready Preview, Comment Mar 25, 2026 0:00am

Request Review

@linux-foundation-easycla
Copy link
Copy Markdown

linux-foundation-easycla bot commented Mar 25, 2026

CLA Signed

The committers listed above are authorized under a signed CLA.

@KumarMunesh12
Copy link
Copy Markdown
Author

Hello Maintainer, Please Review my PR, Tell me what improvements need. Thank You

Comment thread src/content/index.mdx Outdated
</div>

Then run `webpack` on the command-line to create `bundle.js`.
Then run `npx webpack` on the command-line to create `bundle.js`.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Don't use npx

Copy link
Copy Markdown
Author

@KumarMunesh12 KumarMunesh12 Mar 25, 2026

Choose a reason for hiding this comment

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

Thanks! Got it, will i revert that line back to webpack.

Should I leave it as-is or add a note pointing to the npm scripts
approach? Happy to do either.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

You can use webpack after installation without extra scripts

@evenstensberg
Copy link
Copy Markdown
Member

use our pr template.

@KumarMunesh12
Copy link
Copy Markdown
Author

KumarMunesh12 commented Apr 18, 2026

hello maintainer @evenstensberg, i hope you are fit and fine. I was enable to check update on it because of my mid exam,and also iam unaware of pr template. if there is any invalid solution so please guide me to give my best.As i apply for Gsoc 26 it is effecting my proposal because i mention this pr in proposal.

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.

Feedback on the front page UX for getting started with Webpack

3 participants