You might have noticed that webpack 2 reached a final release. That means it's a good time to update this book as well. Even though it's mostly a maintenance release, there's some new content in store.
Compared to the previous release this one feels more solid and should be a little easier to approach. A lot of grammatical issues were eliminated in addition to other tweaks. This work is a part of the hardening required for a paper release.
If you aren't interested in what has changed, skip straight to the book.
Overview of the Situation#
When I started working on the book again, I had roughly three hundred issues on my list to tackle. Roughly 40 remains. The current content requires certain minor tweaks. Also a couple of new chapters are required. After that we are good to go with the milestone release.
This time around my special thanks go to Alexander Zaytsev for his awesome feedback on the content that allowed me to push it further. Thanks Alexander!
The next release might be the last before the book reaches 2.0. It's not too late to contribute specific ideas on what to cover at the book. Open issues as you see fit. You can also reach me through Gitter.
Book Improvements -
In total 118 commits went to the book since the last release. You can find the important changes below. See GitHub for all changes. Remember especially the "Files changed" tab as it gives you a good overview of what's happening with the book.
This time around I made a couple of "silent" releases (no notification on Leanpub) to get smaller fixes in. I will likely continue this habit as it's more in line with the way I like to work and publish.
Structurally the biggest change was pushing the configuration splitting chapter at the end of its part. Earlier it was too early and you understand the idea better after you experience some of the pain the approach solves.
I had a pair of non-technical editors go through the content. This alone lead to hundreds of little fixes all around the content. You won't notice most of them, but I feel it contributes towards the overall quality. It's impossible for me to fix the paper book so it's better to do this now.
Developing with Webpack#
Automatic Browser Refresh#
- This chapter is right after the Getting Started one now. The splitting idea is covered at the end of the part. The flow of the book feels better this way and it should be easier for beginners to pick up.
- The chapter has been largely redeveloped. Especially
--envfits the whole better now.
Configuring Hot Module Replacement#
- Listed some of the features of webpack-dev-server that weren't mentioned earlier. At least this way you know what it's capable of.
- Added a screenshot to clarify the idea.
- This chapter is largely the same as before except this time around you can see better the difference the approach makes.
- Rewrote PostCSS approach to use
- Pushed the import tilde idea to a single section to simplify further.
- Added sections on sourcemaps, Bootstrap, and converting CSS to a string (Angular).
- Improved the quality of the images.
- Ported PostCSS to
optionsbased scheme to encapsulate the idea better.
- Added more detail to the main example.
- Discussed inline definitions in greater detail.
- Simplified a notch while adding a better example for Font Awesome.
- Explained the idea of pitch loaders.
Building with Webpack#
- Expanded on the basic ideas and especially
- Added a section on chunk merging and splitting.
- Added more examples and related patterns.
Processing with Babel#
- Added sections on TypeScript and Flow and explained them in greater detail than earlier.
Hosting on GitHub Pages#
- Added an example of how to resolve
- Explained the basic idea of tree shaking with a small demonstration.
Adding Hashes to Filenames#
- Explained the idea of records and why/how to use them.
- Added a section on how to deal with globals, like jQuery, using webpack as this is a common problem.
- Added a React specific code splitting example.
- Pushed TypeScript and Flow bits to the Babel chapter as those fit below compiling topic.
I'll continue on my task list. I don't expect the current content will change a lot. It's possible the Writing Loaders chapter will go to a part with a similar chapter for plugins and I have prepared a plugin example for the chapter already. The plugin will eventually replace the current Purify plugin of the book.
I expect the next release has at least a couple of more chapters to make the book complete enough for a paper release.
I hope you enjoy the new version. There were quite a few smaller changes that I didn't cover, but it's up to you to discover those.
If you want to support the development of the book, pick up a copy at Leanpub. A part of the income (around ~30%) goes to Tobias Koppers, the author of webpack. This is my way of supporting his work given mine builds on top of his. Literally most of the income goes to webpack developers now!
You can support webpack through open collective too.