webpack/webpack.js.org

Document webpack change: improve merging of resolve and parsing options

Open

#3,197 opened on Jul 17, 2019

View on GitHub
 (2 comments) (0 reactions) (0 assignees)MDX (3,436 forks)github user discovery
ConfigurationHelp Wanted

Repository metrics

Stars
 (2,268 stars)
PR merge metrics
 (PR metrics pending)

Description

A pull request by @sokra was merged and maintainers requested a documentation change.

See pull request: https://github.com/webpack/webpack/pull/9422

by rules and via loader API

Arrays overwrite by default, but can reference old value with "..."

partial backport of https://github.com/webpack/webpack/pull/9126

What kind of change does this PR introduce? feature

Did you add tests for your changes? yes

Does this PR introduce a breaking change? no

What needs to be documented once your changes are merged? Merging of Rule.resolve/Rule.parser objects has a new feature: In array the special "..." item can now be used to reference to old value, while otherwise array values overwrite each other. This also affects the getResolve(options) API in the loader API

Contributor guide

Research direction
Read the linked PR (webpack/webpack#9422) to understand the new merging behavior for resolve and parser options. Then update the documentation on webpack.js.org to describe the array overwrite behavior and the use of '...' to reference old values, covering both Rule.resolve/Rule.parser and the getResolve() API in loaders.
Tech stack
javascriptnodejs
Domain
documentationdeveloper experience
Issue type
Documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
1
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
Git
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
80