From 20c83cfb701246eaa3d1f25ff86ef035958cace3 Mon Sep 17 00:00:00 2001 From: Brian Muenzenmeyer Date: Sun, 23 Mar 2025 16:31:45 -0500 Subject: [PATCH 1/8] doc: fix heading levels in advocacy-ambassador-program.md --- .../advocacy-ambassador-program.md | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/doc/contributing/advocacy-ambassador-program.md b/doc/contributing/advocacy-ambassador-program.md index 76f29b73586691..20de6d43f93652 100644 --- a/doc/contributing/advocacy-ambassador-program.md +++ b/doc/contributing/advocacy-ambassador-program.md @@ -123,12 +123,12 @@ when no longer relevant. The goal is to raise awareness of XYZ in the JavaScript ecosystem. -#### Related Links +##### Related Links List of links with more information about the topic to provide brackground or the information to be shared. -#### Project contacts +##### Project contacts Add a list of GitHub handles for those within the project that have volunteered to be contacated when necessary by ambassadors @@ -157,7 +157,7 @@ Some of the things to highlight include: * Single threaded programming model enables very low resource consumption, making it ideal for containerised workloads. * Highly vibrant ecosystem with enterprise support from many vendors. -#### Related Links +##### Related Links * * @@ -165,13 +165,13 @@ Some of the things to highlight include: * for slide usage and topping recent surveys. -#### Project contacts +##### Project contacts * @mhdawson -### How things get done in the Node.js project +#### How things get done in the Node.js project -#### Goal +##### Goal Help people understand that no people are paid to answer their issues or implement their pull requests. Things get done based on what volunteers work on @@ -210,11 +210,11 @@ Some of the things to highlight include: * If you depend on timely support or an SLA, contract with a company that provides paid support and will prioritize your issues. -#### Related Links +##### Related Links * -#### Project contacts +##### Project contacts * @mcollina * @mhdawson @@ -233,7 +233,7 @@ Some of the things to highlight include: * The `tsconfig.json` configuration options to use in combination for type checking. * Updates on the implementation advancements. -#### Related Links +##### Related Links @@ -245,6 +245,6 @@ Some of the things to highlight include: -#### Project contacts +##### Project contacts * @marco-ippolito From a63292945d5c85960ee7fd236f34af31e963d20b Mon Sep 17 00:00:00 2001 From: Brian Muenzenmeyer Date: Sun, 23 Mar 2025 16:33:52 -0500 Subject: [PATCH 2/8] doc: fix typos --- .../advocacy-ambassador-program.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/doc/contributing/advocacy-ambassador-program.md b/doc/contributing/advocacy-ambassador-program.md index 20de6d43f93652..4984a32ee7f96b 100644 --- a/doc/contributing/advocacy-ambassador-program.md +++ b/doc/contributing/advocacy-ambassador-program.md @@ -125,27 +125,27 @@ The goal is to raise awareness of XYZ in the JavaScript ecosystem. ##### Related Links -List of links with more information about the topic to provide brackground +List of links with more information about the topic to provide background or the information to be shared. ##### Project contacts Add a list of GitHub handles for those within the project that -have volunteered to be contacated when necessary by ambassadors +have volunteered to be contacted when necessary by ambassadors to get more info about the message to be promoted. #### Node.js is a great choice for a JavaScript runtime ##### Goal -Highlight the benefits of chosing Node.js as your backend JavaScript runtime. Focus on what is great +Highlight the benefits of choosing Node.js as your backend JavaScript runtime. Focus on what is great about Node.js without drawing comparisons to alternatives. We don't want to say negative things about other options, only highlight what is great about Node.js as a choice. Some of the things to highlight include: -* How widely it is used (you never get fired for chosing Node.js). -* The openess of the project. It is part of the OpenJS Foundation and it's governance is set up to avoid +* How widely it is used (you never get fired for choosing Node.js). +* The openness of the project. It is part of the OpenJS Foundation and it's governance is set up to avoid any one company from dominating the project. Decisions are made by the collaborators (of which there are quite a few) versus a small number of people. * It has predictable and stable releases and has delivered on the release schedule since 2015. @@ -182,7 +182,7 @@ Some of the things to highlight include: * Nobody is paid specifically to answer issues, fix bugs or implement new features. * No company owns/supports Node.js. Most contributions are from individuals as opposed to organizations. When an individual becomes a collaborator - the access and priviledges are granted to the indidual, their employer does + the access and privileges are granted to the individual, their employer does not gain any additional rights in the project. * The governance of the project is specifically designed to prevent one or a small number of companies from dominating the project. @@ -198,10 +198,10 @@ Some of the things to highlight include: * People are volunteering their time to review your PRs and answer questions in the issues you open. Be mindfull of your asks for their time and acknowledge the gift of their time. Too many issues/PRs in a short period of time may - overwelm maintainers leading to less progress versus more, try to pace your + overwhelm maintainers leading to less progress versus more, try to pace your issues and PRs so that you don't have too many open at the same time. The - same goes for comments in discussions, try to avoid overwelming a discussion - with too many responses, even too much useful data can overwelm a discussion + same goes for comments in discussions, try to avoid overwhelming a discussion + with too many responses, even too much useful data can overwhelm a discussion leading to lower engagement. * While volunteers work to do the right thing for the community, the project does not owe anybody anything and does not tolerate abusive or From 88373f1b609830e9ee380118d231d20e3c95131c Mon Sep 17 00:00:00 2001 From: Brian Muenzenmeyer Date: Sun, 23 Mar 2025 16:44:05 -0500 Subject: [PATCH 3/8] doc: add dependency discussion to ambassadors program --- .../advocacy-ambassador-program.md | 37 +++++++++++++++++++ 1 file changed, 37 insertions(+) diff --git a/doc/contributing/advocacy-ambassador-program.md b/doc/contributing/advocacy-ambassador-program.md index 4984a32ee7f96b..ded4548d23c658 100644 --- a/doc/contributing/advocacy-ambassador-program.md +++ b/doc/contributing/advocacy-ambassador-program.md @@ -248,3 +248,40 @@ Some of the things to highlight include: ##### Project contacts * @marco-ippolito + +#### Do I Still Need This Node.js Dependency? + +##### Goal + +Advancements over time in Node.js are improving the out of the box experience. New versions are released all the time across Active LTS and Current development lines. It's easy to miss something between the release notes and our busy work schedules. + +Each of these on its own is respectable, but together they make a more cohesive narrative. This also shows a [healthy ecosystem at work](https://brianmuenzenmeyer.com/posts/2024-do-i-need-this-node-dependency/#oss-pace-layers), with projects learning from one another and their users. + +"Recent" new or newish features, ordered by availability: + +| Feature | Introduced | Release Status | +| --------------------------------------------- | ---------- | ------------------------------------------------------------------ | +| [testing source code](https://nodejs.org/api/test.html) | [16.17.0](https://nodejs.org/en/blog/release/v16.17.0) | Stable as of 20.0.0 | +| [watching source code](https://nodejs.org/api/cli.html#--watch) | [16.19.0](https://nodejs.org/en/blog/release/v16.19.0) | Stable as of 20.13.0 | +| [parsing arguments](https://nodejs.org/api/util.html#utilparseargsconfig) | [18.3.0](https://nodejs.org/en/blog/release/v18.3.0) | Stable as of 20.0.0 | +| [reading environment](https://nodejs.org/api/cli.html#--env-fileconfig) | [20.6.0](https://nodejs.org/en/blog/release/v20.6.0) | Active Development | +| [styling output](https://nodejs.org/docs/latest-v22.x/api/util.html#utilstyletextformat-text-options) | [20.12.0](https://nodejs.org/en/blog/release/v20.12.0) | Stable, as of [22.13.0](https://github.com/nodejs/node/pull/56329) | +| [run typescript](https://nodejs.org/api/cli.html#--experimental-strip-types) | [22.6.0](https://nodejs.org/en/blog/release/v22.6.0) | Active Development + +##### Related Links + + + +* +* +* +* +* +* +* + + + +##### Project contacts + +* @bmuenzenmeyer From 12abe2f20cc6ad2bf257a1b691ead0273e536a49 Mon Sep 17 00:00:00 2001 From: Brian Muenzenmeyer Date: Sun, 23 Mar 2025 16:58:51 -0500 Subject: [PATCH 4/8] doc: format doc\contributing\advocacy-ambassador-program.md --- doc/contributing/advocacy-ambassador-program.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/doc/contributing/advocacy-ambassador-program.md b/doc/contributing/advocacy-ambassador-program.md index ded4548d23c658..73cda3a493f4b4 100644 --- a/doc/contributing/advocacy-ambassador-program.md +++ b/doc/contributing/advocacy-ambassador-program.md @@ -259,14 +259,14 @@ Each of these on its own is respectable, but together they make a more cohesive "Recent" new or newish features, ordered by availability: -| Feature | Introduced | Release Status | -| --------------------------------------------- | ---------- | ------------------------------------------------------------------ | -| [testing source code](https://nodejs.org/api/test.html) | [16.17.0](https://nodejs.org/en/blog/release/v16.17.0) | Stable as of 20.0.0 | -| [watching source code](https://nodejs.org/api/cli.html#--watch) | [16.19.0](https://nodejs.org/en/blog/release/v16.19.0) | Stable as of 20.13.0 | -| [parsing arguments](https://nodejs.org/api/util.html#utilparseargsconfig) | [18.3.0](https://nodejs.org/en/blog/release/v18.3.0) | Stable as of 20.0.0 | -| [reading environment](https://nodejs.org/api/cli.html#--env-fileconfig) | [20.6.0](https://nodejs.org/en/blog/release/v20.6.0) | Active Development | -| [styling output](https://nodejs.org/docs/latest-v22.x/api/util.html#utilstyletextformat-text-options) | [20.12.0](https://nodejs.org/en/blog/release/v20.12.0) | Stable, as of [22.13.0](https://github.com/nodejs/node/pull/56329) | -| [run typescript](https://nodejs.org/api/cli.html#--experimental-strip-types) | [22.6.0](https://nodejs.org/en/blog/release/v22.6.0) | Active Development +| Feature | Introduced | Release Status | +| ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------ | +| [testing source code](https://nodejs.org/api/test.html) | [16.17.0](https://nodejs.org/en/blog/release/v16.17.0) | Stable as of 20.0.0 | +| [watching source code](https://nodejs.org/api/cli.html#--watch) | [16.19.0](https://nodejs.org/en/blog/release/v16.19.0) | Stable as of 20.13.0 | +| [parsing arguments](https://nodejs.org/api/util.html#utilparseargsconfig) | [18.3.0](https://nodejs.org/en/blog/release/v18.3.0) | Stable as of 20.0.0 | +| [reading environment](https://nodejs.org/api/cli.html#--env-fileconfig) | [20.6.0](https://nodejs.org/en/blog/release/v20.6.0) | Active Development | +| [styling output](https://nodejs.org/docs/latest-v22.x/api/util.html#utilstyletextformat-text-options) | [20.12.0](https://nodejs.org/en/blog/release/v20.12.0) | Stable, as of [22.13.0](https://github.com/nodejs/node/pull/56329) | +| [run typescript](https://nodejs.org/api/cli.html#--experimental-strip-types) | [22.6.0](https://nodejs.org/en/blog/release/v22.6.0) | Active Development | ##### Related Links From 0c54864856b18824cc1dbfdaa13426edde801f27 Mon Sep 17 00:00:00 2001 From: Brian Muenzenmeyer Date: Sun, 23 Mar 2025 17:06:23 -0500 Subject: [PATCH 5/8] doc: format doc\contributing\advocacy-ambassador-program.md --- doc/contributing/advocacy-ambassador-program.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/doc/contributing/advocacy-ambassador-program.md b/doc/contributing/advocacy-ambassador-program.md index 73cda3a493f4b4..4124d6ab3bfa55 100644 --- a/doc/contributing/advocacy-ambassador-program.md +++ b/doc/contributing/advocacy-ambassador-program.md @@ -253,9 +253,13 @@ Some of the things to highlight include: ##### Goal -Advancements over time in Node.js are improving the out of the box experience. New versions are released all the time across Active LTS and Current development lines. It's easy to miss something between the release notes and our busy work schedules. +Advancements over time in Node.js are improving the out of the box experience. +New versions are released all the time across Active LTS and Current development lines. +It's easy to miss something between the release notes and our busy work schedules. -Each of these on its own is respectable, but together they make a more cohesive narrative. This also shows a [healthy ecosystem at work](https://brianmuenzenmeyer.com/posts/2024-do-i-need-this-node-dependency/#oss-pace-layers), with projects learning from one another and their users. +Each of these on its own is respectable, but together they make a more cohesive narrative. +This also shows a [healthy ecosystem at work](https://brianmuenzenmeyer.com/posts/2024-do-i-need-this-node-dependency/#oss-pace-layers), +with projects learning from one another and their users. "Recent" new or newish features, ordered by availability: @@ -266,7 +270,7 @@ Each of these on its own is respectable, but together they make a more cohesive | [parsing arguments](https://nodejs.org/api/util.html#utilparseargsconfig) | [18.3.0](https://nodejs.org/en/blog/release/v18.3.0) | Stable as of 20.0.0 | | [reading environment](https://nodejs.org/api/cli.html#--env-fileconfig) | [20.6.0](https://nodejs.org/en/blog/release/v20.6.0) | Active Development | | [styling output](https://nodejs.org/docs/latest-v22.x/api/util.html#utilstyletextformat-text-options) | [20.12.0](https://nodejs.org/en/blog/release/v20.12.0) | Stable, as of [22.13.0](https://github.com/nodejs/node/pull/56329) | -| [run typescript](https://nodejs.org/api/cli.html#--experimental-strip-types) | [22.6.0](https://nodejs.org/en/blog/release/v22.6.0) | Active Development | +| [run TypeScript](https://nodejs.org/api/cli.html#--experimental-strip-types) | [22.6.0](https://nodejs.org/en/blog/release/v22.6.0) | Active Development | ##### Related Links From 6dd548344760bd40bd4fea8e76b23167254fa963 Mon Sep 17 00:00:00 2001 From: Brian Muenzenmeyer Date: Sun, 23 Mar 2025 21:54:30 -0500 Subject: [PATCH 6/8] Update doc/contributing/advocacy-ambassador-program.md Co-authored-by: Antoine du Hamel --- doc/contributing/advocacy-ambassador-program.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/contributing/advocacy-ambassador-program.md b/doc/contributing/advocacy-ambassador-program.md index 4124d6ab3bfa55..80668de5d8351d 100644 --- a/doc/contributing/advocacy-ambassador-program.md +++ b/doc/contributing/advocacy-ambassador-program.md @@ -249,7 +249,7 @@ Some of the things to highlight include: * @marco-ippolito -#### Do I Still Need This Node.js Dependency? +#### Do I still need this dependency for my Node.js app? ##### Goal From 2d049d435b4c2a60a1fa64115d26f648d01185df Mon Sep 17 00:00:00 2001 From: Brian Muenzenmeyer Date: Mon, 5 May 2025 22:17:25 -0500 Subject: [PATCH 7/8] doc: add node --run suggestion --- doc/contributing/advocacy-ambassador-program.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/doc/contributing/advocacy-ambassador-program.md b/doc/contributing/advocacy-ambassador-program.md index 80668de5d8351d..fc1b18e2e23a7f 100644 --- a/doc/contributing/advocacy-ambassador-program.md +++ b/doc/contributing/advocacy-ambassador-program.md @@ -270,6 +270,7 @@ with projects learning from one another and their users. | [parsing arguments](https://nodejs.org/api/util.html#utilparseargsconfig) | [18.3.0](https://nodejs.org/en/blog/release/v18.3.0) | Stable as of 20.0.0 | | [reading environment](https://nodejs.org/api/cli.html#--env-fileconfig) | [20.6.0](https://nodejs.org/en/blog/release/v20.6.0) | Active Development | | [styling output](https://nodejs.org/docs/latest-v22.x/api/util.html#utilstyletextformat-text-options) | [20.12.0](https://nodejs.org/en/blog/release/v20.12.0) | Stable, as of [22.13.0](https://github.com/nodejs/node/pull/56329) | +| [run scripts](https://nodejs.org/docs/latest/api/cli.html#--run) | [22.0.0](https://nodejs.org/en/blog/release/v22.0.0) | Stable, as of 22.0.0 | | [run TypeScript](https://nodejs.org/api/cli.html#--experimental-strip-types) | [22.6.0](https://nodejs.org/en/blog/release/v22.6.0) | Active Development | ##### Related Links @@ -282,6 +283,7 @@ with projects learning from one another and their users. * * * +* * From 715b3266e024218feef49985420a9716cab9b965 Mon Sep 17 00:00:00 2001 From: Brian Muenzenmeyer Date: Mon, 5 May 2025 22:24:03 -0500 Subject: [PATCH 8/8] doc: manually format file again --- doc/contributing/advocacy-ambassador-program.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/contributing/advocacy-ambassador-program.md b/doc/contributing/advocacy-ambassador-program.md index fc1b18e2e23a7f..e8c7936c9412b4 100644 --- a/doc/contributing/advocacy-ambassador-program.md +++ b/doc/contributing/advocacy-ambassador-program.md @@ -270,7 +270,7 @@ with projects learning from one another and their users. | [parsing arguments](https://nodejs.org/api/util.html#utilparseargsconfig) | [18.3.0](https://nodejs.org/en/blog/release/v18.3.0) | Stable as of 20.0.0 | | [reading environment](https://nodejs.org/api/cli.html#--env-fileconfig) | [20.6.0](https://nodejs.org/en/blog/release/v20.6.0) | Active Development | | [styling output](https://nodejs.org/docs/latest-v22.x/api/util.html#utilstyletextformat-text-options) | [20.12.0](https://nodejs.org/en/blog/release/v20.12.0) | Stable, as of [22.13.0](https://github.com/nodejs/node/pull/56329) | -| [run scripts](https://nodejs.org/docs/latest/api/cli.html#--run) | [22.0.0](https://nodejs.org/en/blog/release/v22.0.0) | Stable, as of 22.0.0 | +| [run scripts](https://nodejs.org/docs/latest/api/cli.html#--run) | [22.0.0](https://nodejs.org/en/blog/release/v22.0.0) | Stable, as of 22.0.0 | | [run TypeScript](https://nodejs.org/api/cli.html#--experimental-strip-types) | [22.6.0](https://nodejs.org/en/blog/release/v22.6.0) | Active Development | ##### Related Links