How to - Develop

[bebraw]

Stub.

Feel free to comment here if you have ideas on what this guide should cover. Link to potential resources too.

[mxstbr]

TL;DR of contents:

The webpack-dev-server allows users to run a web-server from the command line that's enhanced with some webpack-specific events which enable certain features like hot-module-reloading.

The watch mode, as the name suggest, watches your filesystem for changes in the files that webpack cares about in its bundle. If a file is changed, webpack automatically rebuilds the bundle and sends it to the client via the dev server.

---

Should we also touch on HMR in this section possibly?

[bebraw]

I ended up stubbing how to develop? kind of article at my Antwar based prototype. It would cover --watch, HMR, webpack-dev-server.

I actually have a related chapter here.

If we can keep the site pages simple and link to external resources at the end, that would get us pretty far I think.

[mxstbr]

Yeah that sounds very reasonable

[e-cloud]

Including the documentation about the API of webpack-dev-server would be better.

[SpaceK33z]

I'm helping maintaining WDS, and looking through the issues, these occur the most:

• Using it with Docker.
• Using it with a proxy, and after they get that working, CORS.
• Getting it to work with vagrant (need to use --watch-poll, and a custom 'public' url).
• Wanting to use [hash] in file, which causes a memory leak and many other weird issues (make clear that cache busting is not necessary for dev!).

I'll try to write some documentation soon (1-2 weeks) on this part.

[bebraw]

@SpaceK33z There's a separate issue related to Docker (#44). I expect similar articles for the rest (proxying, Vagrant) would work too. Small, focused "how tos" would be great.

[SpaceK33z]

So in #78 I've written some documentation on how to use it with Vagrant.

I noticed that the current documentation of WDS is not yet ported. Is this something I could work on? If yes, where would this documentation live? Maybe in api/dev-server-cli.md, api/dev-server-node.md and put the examples etc. in how-to/develop.md?

[bebraw]

I noticed that the current documentation of WDS is not yet ported. Is this something I could work on? If yes, where would this documentation live? Maybe in api/dev-server-cli.md, api/dev-server-node.md and put the examples etc. in how-to/develop.md?

Yeah, that would be great. The suggested articles would work well.

[SpaceK33z]

I'm currently working on this, if anybody wants to help, please discuss first to prevent duplicate work.