Webpack.js.org: [Dependency: Guides] - Add v4 Migration Guide

Created on 20 Mar 2018  路  7Comments  路  Source: webpack/webpack.js.org

Dependency for #1859

Goal: As a user looking to upgrade to webpack 4, I would like step by step instructions for any changes I need to make from my v3 configuration to update to webpack 4

MVP

  • [ ] Create new v4 Migration guide and place in "Migrating" section.
  • [ ] The url should be webpack.js.org/migrate/4
  • [ ] The migration guide should be formatted in the same way as the v3 migration guide (diff style)
  • [ ] For loaders and plugins, link to new Plugin and Loader reference implementation docs
Documentation Guides Help Wanted

Most helpful comment

Any updates? With 4 being the recommended and advertised version, a migration guide is really needed for users of webpack 3...

All 7 comments

Hey Sean and the rest of the amazing contributors of Webpack! I would like to give back to the webpack community by contributing to the migration guide from v3 to v4 but I'm not sure where to start. Could you please help me get started with that? Thank you. :)

Hey @onstash. :wave:
One of the best places to look for v4 changes is this release note.
I'd also recommend reading our medium blog's latest posts as well as looking over v4 docs.
Welcome aboard. :shipit:

@onstash It looks like @sokra started a PR that you could review!!! What might be a great intro into the repo is https://github.com/webpack/webpack.js.org/issues/1933 which will let you get familiar with how the content is laid out in the source. How does that sound?

@dhruvdutt Thank you for listing those links. It actually helped me get started with the migration docs. :)

@TheLarkInn Ah. I just raised a PR that had a skeletal version of the migration docs. It's alright. I have closed in favor of #1939.

Guys. Is it possible to contribute in a different way with respect to documentation?

@onstash, There are opportunities for everybody to contribute to webpack. :)

There are some minor issues in v4 docs PR #1856 which we haven't addressed yet. You can see the review comments to resolve them.
Also, take a look at the open issues with Help Wanted label.

@onstash @TheLarkInn I lack a bit of expertise to make good sense of the docs, which has prevented me from upgrading (barely got the webpack to do what I need ><). So props to you for driving this initiative! Will look forward to what's coming 馃憦馃憦馃憦

Any updates? With 4 being the recommended and advertised version, a migration guide is really needed for users of webpack 3...

Was this page helpful?
0 / 5 - 0 ratings