Link to concepts from guides (or maybe rename some things?)

[dmitriid]

Very few, if any, beginners (or even more advanced users) will go to the concepts page. Quite often "concepts" pages describe white papers, or system architecture, or some other deeply technical and/or philosophical thing.

People will be almost immediately drawn to the guides section, as they will expect the guides to be a gentle/easy/simple introduction and walkthrough to the system.

However, https://webpack.js.org/concepts/ is a very good starting point. It actually has a gentle introduction and keeps on explaining various things while being very gentle. At the same time the guides section is frankly intimidating. It dumps a lot of advanced stuff on you with little to no explanation of, well, concepts.

IMO:

• "concepts" should be renamed to "guides"/"guide"
• "guides" should be renamed to "in-depth guides" or "handbook"

or

• concepts should be linked to from guides prominently, in every guide

---

Comparisons:

Rollup

Rollup's guide goes in baby steps from explaining what it is, to creating a first bundle, to plugins etc. I would say it basically mirrors what webpack calls concepts.

Browserify

Their documentation is not in as good a shape, but what webpack calls guides is essentially called a handbook

Gulp

A horrible mess of recipes basically correspond to webpack's guides.

etc.

[dmitriid]

Closing this in favour of #749