Skip to content

Commit 3684f10

Browse files
committed
doc: final round of markdown format changes
Once the README and find-inactive-collaborators.mjs changes land here, we can introduce markdown formatting as a step in the toolchain somewhere. Before this lands, nodejs/node-core-utils#578 will need to land and be included in a node-core-utils release.
1 parent e937662 commit 3684f10

10 files changed

+458
-448
lines changed

README.md

+245-245
Large diffs are not rendered by default.

doc/api/esm.md

+16-16
Original file line numberDiff line numberDiff line change
@@ -1116,21 +1116,21 @@ The resolver can throw the following errors:
11161116
> **PACKAGE\_SELF\_RESOLVE**(_packageName_, _packageSubpath_, _parentURL_).
11171117
> 10. If _selfUrl_ is not **undefined**, return _selfUrl_.
11181118
> 11. While _parentURL_ is not the file system root,
1119-
> 1. Let _packageURL_ be the URL resolution of _"node_modules/"_
1120-
> concatenated with _packageSpecifier_, relative to _parentURL_.
1121-
> 2. Set _parentURL_ to the parent folder URL of _parentURL_.
1122-
> 3. If the folder at _packageURL_ does not exist, then
1123-
> 1. Continue the next loop iteration.
1124-
> 4. Let _pjson_ be the result of **READ\_PACKAGE\_JSON**(_packageURL_).
1125-
> 5. If _pjson_ is not **null** and _pjson_._exports_ is not **null** or
1126-
> **undefined**, then
1127-
> 1. Return the result of **PACKAGE\_EXPORTS\_RESOLVE**(_packageURL_,
1128-
> _packageSubpath_, _pjson.exports_, _defaultConditions_).
1129-
> 6. Otherwise, if _packageSubpath_ is equal to _"."_, then
1130-
> 1. If _pjson.main_ is a string, then
1131-
> 1. Return the URL resolution of _main_ in _packageURL_.
1132-
> 7. Otherwise,
1133-
> 1. Return the URL resolution of _packageSubpath_ in _packageURL_.
1119+
> 1. Let _packageURL_ be the URL resolution of _"node\_modules/"_
1120+
> concatenated with _packageSpecifier_, relative to _parentURL_.
1121+
> 2. Set _parentURL_ to the parent folder URL of _parentURL_.
1122+
> 3. If the folder at _packageURL_ does not exist, then
1123+
> 1. Continue the next loop iteration.
1124+
> 4. Let _pjson_ be the result of **READ\_PACKAGE\_JSON**(_packageURL_).
1125+
> 5. If _pjson_ is not **null** and _pjson_._exports_ is not **null** or
1126+
> **undefined**, then
1127+
> 1. Return the result of **PACKAGE\_EXPORTS\_RESOLVE**(_packageURL_,
1128+
> _packageSubpath_, _pjson.exports_, _defaultConditions_).
1129+
> 6. Otherwise, if _packageSubpath_ is equal to _"."_, then
1130+
> 1. If _pjson.main_ is a string, then
1131+
> 1. Return the URL resolution of _main_ in _packageURL_.
1132+
> 7. Otherwise,
1133+
> 1. Return the URL resolution of _packageSubpath_ in _packageURL_.
11341134
> 12. Throw a _Module Not Found_ error.
11351135

11361136
**PACKAGE\_SELF\_RESOLVE**(_packageName_, _packageSubpath_, _parentURL_)
@@ -1242,7 +1242,7 @@ _internal_, _conditions_)
12421242
> 1. Return **PACKAGE\_RESOLVE**(_target_ with every instance of
12431243
> _"\*"_ replaced by _subpath_, _packageURL_ + _"/"_).
12441244
> 2. Return **PACKAGE\_RESOLVE**(_target_ + _subpath_,
1245-
> _packageURL_ + _"/"_)_.
1245+
> _packageURL_ + _"/"_).
12461246
> 2. Otherwise, throw an _Invalid Package Target_ error.
12471247
> 3. If _target_ split on _"/"_ or _"\\"_ contains any _"."_, _".."_ or
12481248
> _"node\_modules"_ segments after the first segment, case insensitive and

doc/api/n-api.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -1009,8 +1009,8 @@ The content of the `napi_extended_error_info` returned is only valid up until
10091009
a Node-API function is called on the same `env`. This includes a call to
10101010
`napi_is_exception_pending` so it may often be necessary to make a copy
10111011
of the information so that it can be used later. The pointer returned
1012-
in error_message points to a statically defined string so it is safe to use
1013-
that pointer if you have copied it out of the error_message field (which will
1012+
in error\_message points to a statically defined string so it is safe to use
1013+
that pointer if you have copied it out of the error\_message field (which will
10141014
be overwritten) before another Node-API function was called.
10151015

10161016
Do not rely on the content or format of any of the extended information as it

doc/changelogs/CHANGELOG_V12.md

+4-3
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,7 @@
8181
* [Archive](CHANGELOG\_ARCHIVE.md)
8282

8383
<a id="12.22.7"></a>
84+
8485
## 2021-10-12, Version 12.22.7 'Erbium' (LTS), @danielleadams
8586

8687
This is a security release.
@@ -94,9 +95,9 @@ This is a security release.
9495

9596
### Commits
9697

97-
* [[`21a2e554e3`](https://github.com/nodejs/node/commit/21a2e554e3)] - **deps**: update llhttp to 2.1.4 (Fedor Indutny) [nodejs-private/node-private#286](https://github.com/nodejs-private/node-private/pull/286)
98-
* [[`d5d3a03246`](https://github.com/nodejs/node/commit/d5d3a03246)] - **http**: add regression test for smuggling content length (Matteo Collina) [nodejs-private/node-private#286](https://github.com/nodejs-private/node-private/pull/286)
99-
* [[`0858587f21`](https://github.com/nodejs/node/commit/0858587f21)] - **http**: add regression test for chunked smuggling (Matteo Collina) [nodejs-private/node-private#286](https://github.com/nodejs-private/node-private/pull/286)
98+
* \[[`21a2e554e3`](https://github.com/nodejs/node/commit/21a2e554e3)] - **deps**: update llhttp to 2.1.4 (Fedor Indutny) [nodejs-private/node-private#286](https://github.com/nodejs-private/node-private/pull/286)
99+
* \[[`d5d3a03246`](https://github.com/nodejs/node/commit/d5d3a03246)] - **http**: add regression test for smuggling content length (Matteo Collina) [nodejs-private/node-private#286](https://github.com/nodejs-private/node-private/pull/286)
100+
* \[[`0858587f21`](https://github.com/nodejs/node/commit/0858587f21)] - **http**: add regression test for chunked smuggling (Matteo Collina) [nodejs-private/node-private#286](https://github.com/nodejs-private/node-private/pull/286)
100101

101102
<a id="12.22.6"></a>
102103

doc/changelogs/CHANGELOG_V14.md

+4-3
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,7 @@
6969
* [Archive](CHANGELOG\_ARCHIVE.md)
7070

7171
<a id="14.18.1"></a>
72+
7273
## 2021-10-12, Version 14.18.1 'Fermium' (LTS), @danielleadams
7374

7475
This is a security release.
@@ -82,9 +83,9 @@ This is a security release.
8283

8384
### Commits
8485

85-
* [[`8c254ca7e4`](https://github.com/nodejs/node/commit/8c254ca7e4)] - **deps**: update llhttp to 2.1.4 (Fedor Indutny) [nodejs-private/node-private#285](https://github.com/nodejs-private/node-private/pull/285)
86-
* [[`9b92ae2499`](https://github.com/nodejs/node/commit/9b92ae2499)] - **http**: add regression test for smuggling content length (Matteo Collina) [nodejs-private/node-private#285](https://github.com/nodejs-private/node-private/pull/285)
87-
* [[`f467539719`](https://github.com/nodejs/node/commit/f467539719)] - **http**: add regression test for chunked smuggling (Matteo Collina) [nodejs-private/node-private#285](https://github.com/nodejs-private/node-private/pull/285)
86+
* \[[`8c254ca7e4`](https://github.com/nodejs/node/commit/8c254ca7e4)] - **deps**: update llhttp to 2.1.4 (Fedor Indutny) [nodejs-private/node-private#285](https://github.com/nodejs-private/node-private/pull/285)
87+
* \[[`9b92ae2499`](https://github.com/nodejs/node/commit/9b92ae2499)] - **http**: add regression test for smuggling content length (Matteo Collina) [nodejs-private/node-private#285](https://github.com/nodejs-private/node-private/pull/285)
88+
* \[[`f467539719`](https://github.com/nodejs/node/commit/f467539719)] - **http**: add regression test for chunked smuggling (Matteo Collina) [nodejs-private/node-private#285](https://github.com/nodejs-private/node-private/pull/285)
8889

8990
<a id="14.18.0"></a>
9091

doc/changelogs/CHANGELOG_V16.md

+10-6
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,7 @@
5555
* [Archive](CHANGELOG\_ARCHIVE.md)
5656

5757
<a id="16.13.0"></a>
58+
5859
## 2021-10-26, Version 16.13.0 'Gallium' (LTS), @richardlau
5960

6061
### Notable Changes
@@ -65,21 +66,23 @@ and will remain so until October 2022. After that time, it will move into
6566
"Maintenance" until end of life in April 2024.
6667

6768
<a id="16.12.0"></a>
69+
6870
## 2021-10-20, Version 16.12.0 (Current), @richardlau
6971

7072
### Notable Changes
7173

7274
#### Experimental ESM Loader Hooks API
7375

7476
Node.js ESM Loader hooks have been consolidated to represent the steps involved needed to facilitate future loader chaining:
75-
1. `resolve`: `resolve` \[+ `getFormat`\]
76-
1. `load`: `getFormat` + `getSource` + `transformSource`
77+
78+
1. `resolve`: `resolve` \[+ `getFormat`]
79+
2. `load`: `getFormat` + `getSource` + `transformSource`
7780

7881
For consistency, `getGlobalPreloadCode` has been renamed to `globalPreload`.
7982

8083
A loader exporting obsolete hook(s) will trigger a single deprecation warning (per loader) listing the errant hooks.
8184

82-
Contributed by Jacob Smith, Geoffrey Booth, and Bradley Farias - https://github.com/nodejs/node/pull/37468
85+
Contributed by Jacob Smith, Geoffrey Booth, and Bradley Farias - <https://github.com/nodejs/node/pull/37468>
8386

8487
#### Other Notable Changes
8588

@@ -150,6 +153,7 @@ Contributed by Jacob Smith, Geoffrey Booth, and Bradley Farias - https://github.
150153
* \[[`4116b6c907`](https://github.com/nodejs/node/commit/4116b6c907)] - **(SEMVER-MINOR)** **vm**: add support for import assertions in dynamic imports (Antoine du Hamel) [#40249](https://github.com/nodejs/node/pull/40249)
151154

152155
<a id="16.11.1"></a>
156+
153157
## 2021-10-12, Version 16.11.1 (Current), @danielleadams
154158

155159
This is a security release.
@@ -163,9 +167,9 @@ This is a security release.
163167

164168
### Commits
165169

166-
* [[`af488f8dc8`](https://github.com/nodejs/node/commit/af488f8dc8)] - **deps**: update llhttp to 6.0.4 (Matteo Collina) [nodejs-private/node-private#284](https://github.com/nodejs-private/node-private/pull/284)
167-
* [[`2d1eefad98`](https://github.com/nodejs/node/commit/2d1eefad98)] - **http**: add regression test for smuggling content length (Matteo Collina) [nodejs-private/node-private#284](https://github.com/nodejs-private/node-private/pull/284)
168-
* [[`45d419ab1c`](https://github.com/nodejs/node/commit/45d419ab1c)] - **http**: add regression test for chunked smuggling (Matteo Collina) [nodejs-private/node-private#284](https://github.com/nodejs-private/node-private/pull/284)
170+
* \[[`af488f8dc8`](https://github.com/nodejs/node/commit/af488f8dc8)] - **deps**: update llhttp to 6.0.4 (Matteo Collina) [nodejs-private/node-private#284](https://github.com/nodejs-private/node-private/pull/284)
171+
* \[[`2d1eefad98`](https://github.com/nodejs/node/commit/2d1eefad98)] - **http**: add regression test for smuggling content length (Matteo Collina) [nodejs-private/node-private#284](https://github.com/nodejs-private/node-private/pull/284)
172+
* \[[`45d419ab1c`](https://github.com/nodejs/node/commit/45d419ab1c)] - **http**: add regression test for chunked smuggling (Matteo Collina) [nodejs-private/node-private#284](https://github.com/nodejs-private/node-private/pull/284)
169173

170174
<a id="16.11.0"></a>
171175

0 commit comments

Comments
 (0)