Webpack 4 - optimization section under configuration

[EugeneHlushko]

• (docs(optimization) Add optimization section to configuration docs #2053) Create the section itself
• (docs(optimization) Add optimization section to configuration docs #2053) minimize
• (docs(optimization) Add optimization section to configuration docs #2053) minimizer (for custom options reference Cannot remove comments from production bundle using optimization.minimize webpack#6879)
• (docs(optimization) Add optimization section to configuration docs #2053) splitChunks
• (Configuration/optimization updates #2112) runtimeChunk
• (Configuration/optimization updates #2112) noEmitOnErrors
• (Docs optimization #2271) namedModules
• (Docs optimization #2271) namedChunks
• (docs(config) optimization portableRecords doc #2456) portableRecords
• (Document optimization.nodeEnv #2139) nodeEnv (also closes Document optimization.nodeEnv #2138)
• (docs(config) document removeAvailableModules option #2273) removeAvailableModules
• (docs(config) document removeEmptyChunks and mergeDuplicateChunks #2295) removeEmptyChunks
• (docs(config) document removeEmptyChunks and mergeDuplicateChunks #2295) mergeDuplicateChunks
• (docs(config) document flagIncludedChunks optimization option #2306) flagIncludedChunks
• (docs(config) document usedExports, providedExports and occurrenceOrder #2345) occurrenceOrder
• (docs(config) document optimization.sideEffects #2392) sideEffects
• (docs(config) document usedExports, providedExports and occurrenceOrder #2345) providedExports
• (docs(config) document usedExports, providedExports and occurrenceOrder #2345) usedExports
• (docs(config) document concatenateModules optimization option #2353) concatenateModules
• (docs(config) Optimization mangleWasmImports option #2265) mangleWasmImports

[jeremenichelli]

Is the intention to tackle some examples on best solutions? Or simply explain configurations of each option? I'm getting the feeling that this could generate duplicated content easily if we are not careful.

[EugeneHlushko]

The plan was to mention these things and what they are doing, what options are available and what the defaults are. Do you think the list should be extended or shortened @jeremenichelli ?

[jeremenichelli]

My fear is to have duplicated references for the same content, but we can always give it a try and see if it does work. There are config that naturally are already present like the plugins for example, so it owuld be good to breifly describe them and link to their proper page, but extend the content on the ones that actually have no other explanation on the site.

[EugeneHlushko]

I got your point, yes everything that has its core page from the list above will be only briefly mentioned and linked to 👍 i did not understand your concern from the first time 😓 😆 @jeremenichelli
P.S. picking this up soon, was busy IRL

[jeremenichelli]

@EugeneHlushko don't worry man, all good. Let me know when you have something, I'll checkout the PR and give it a look locally to see how the final content looks.

[Aqours]

sideEffects section is very puzzling.

// src/index.ts
import './polyfills';
export function f() {}


// src/polyfills.ts
import 'promise-polyfill/src/polyfill';
import 'reflect-metadata'; // npm package

The above content is my TypeScript code.

// config1
// package.json
{
  "sideEffects": [
    "src/polyfills.ts"
  ],
}

// config2
// package.json
{
  "sideEffects": [
    "src/index.ts"
  ],
}

The bundle file include polyfills.ts and promise-polyfill and reflect-metadata npm packages when I use config1, but exclude polyfills.ts and promise-polyfill and reflect-metadata npm packages when I use config2.

I think sideEffects section should account for why config1 include sub-import files and config2 does not. We need more details.

[jeremenichelli]

@Aqours can you put this in a separate issue, I don't it belongs to this discussion and tell us what would work for you better as content in that section. Thanks in advance!