docs(API) Add error report introduction of loaders (#2231)

[mc-zone]

These additions resolve #2231 .

[mc-zone]

[email protected] lint:markdown /home/travis/build/webpack/webpack.js.org
markdownlint --config ./.markdownlint.json .md ./src/content/**/.md
./src/content/api/loaders.md: 355: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 357: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 361: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 366: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 373: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 375: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 382: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 384: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 391: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 394: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 401: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 403: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 410: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 412: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 419: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 421: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 438: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 440: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 447: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 449: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 512: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 514: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 518: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 522: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 526: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 542: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 566: MD031 Fenced code blocks should be surrounded by blank lines
./src/content/api/loaders.md: 572: MD031 Fenced code blocks should be surrounded by blank linesnpm ERR! code ELIFECYCLE

I don't know whether I should fix this. but the CI test can't pass if I don't.

[montogeek]

@mc-zone Yes, you should, It was passing before.

[dhruvdutt]

@mc-zone Not sure why exactly it's failing but take a look at these rules.

[mc-zone]

[email protected] fetch /home/travis/build/webpack/webpack.js.org
sh src/scripts/fetch.sh
{ [Error: {"message":"API rate limit exceeded for 35.184.48.144. (But here's the good news: Authenticated requests get a higher rate limit. Check out the documentation for more details.)","documentation_url":"https://developer.github.com/v3/#rate-limiting"}]
message: '{"message":"API rate limit exceeded for 35.184.48.144. (But here's the good news: Authenticated requests get a higher rate limit. Check out the documentation for more details.)","documentation_url":"https://developer.github.com/v3/#rate-limiting"}',
code: 403,
status: 'Forbidden',

Seems we have to fetch some content every time. Can these be cached or some other workaround? @montogeek

[montogeek]

@mc-zone I have tried, twice (#2270 , #1963), will try again

[mc-zone]

Anyone could review this? is this enough to be merged? 🚶

[montogeek]

Nice additions!

[montogeek]

...while a loader is running is correct.
Correct word is fail.

[EugeneHlushko]

or: Throwing an error while loader is running will cause current module compilation failure.

[montogeek]

Not sure what you mean on this line

[EugeneHlushko]

The module on which loader had thrown this error will get bundled like this:

[montogeek]

As you can see below would sound better

[EugeneHlushko]

For sure, shorter and clearer

[EugeneHlushko]

this sounds abstract, please be more specific. e.g. Here are the ways to throw an error from inside a loader:...

[EugeneHlushko]

[this.emitError](/api/loaders/#this-emiterror) will report the errors without interrupting module's compilation. or any other way you can rephrase this to sound closer to software documentation page

[EugeneHlushko]

see above

[EugeneHlushko]

The loader path in the error is displayed since webpack 4.12

[EugeneHlushko]

I would really love to see texts shaped accordingly with the rest of documentation. Right now they are not of a documentation level

[montogeek]

@mc-zone Friendly ping.

[mc-zone]

Updated. @montogeek @EugeneHlushko Sorry about this...

[EugeneHlushko]

change compiling to compilation to be consistent

[mc-zone]

@montogeek @EugeneHlushko Hi, is there anything else that I should do for this PR? Please tell me if anything wrong. Thanks!

[EugeneHlushko]

Thank you for updating the PR! It looks really good now, a couple of small changes requested and one question re eslint

[EugeneHlushko]

LGTM

[EugeneHlushko]

@montogeek please have another look

[montogeek]

Thanks!