From cf69315037a596182ca55237bda4792dcca87c1d Mon Sep 17 00:00:00 2001 From: Aviv Keller Date: Mon, 27 Oct 2025 15:47:46 -0400 Subject: [PATCH 1/7] Add meeting notes for Node.js Web Team on 2025-10-27 --- meetings/2025-10-27.md | 89 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 89 insertions(+) create mode 100644 meetings/2025-10-27.md diff --git a/meetings/2025-10-27.md b/meetings/2025-10-27.md new file mode 100644 index 0000000..47a0f09 --- /dev/null +++ b/meetings/2025-10-27.md @@ -0,0 +1,89 @@ +# Node.js Web Team Meeting 2025-10-27 + +## Links + +- **GitHub Issue**: https://github.com/nodejs/web-team/issues/56 + +## Present + +- Aviv Keller @avivkeller +- Brian Muenzenmeyer @bmuenzenmeyer +- Matt Cowley @mattipv4 +- Augustin Mauroy @AugustinMauroy +- Claudio Wunder @ovflowd + +## Agenda + +Extracted from **web-agenda** labelled issues and pull requests from the **nodejs org** prior to the meeting. + +### nodejs/nodejs.org + +* Card Sort Session Results [#8234](https://github.com/nodejs/nodejs.org/issues/8234) + * Aviv, explained what happened at the Card Sort + * Brian, we need to analyze the data and look for patterns. Take that, and propose new article layouts + * Brian, let's go over the general concerns + * The navigation is too linear, however, there are many cases where this harms the reader (i.e. when a document contains a sub-document, like "Flame Graphs") + * Aviv, explain the difficulty of getting to certain articles + * Matt, being linear shows users a general order, but we _should_ have sub-articles + * Aviv, the downside of linear articles is that things fall under multiple categories + * Brian, the learn articles look like a pathway, which they aren't really, since you don't *need* the articles to use Node.js + * Aviv, our CSS styles promote that idea that it's a pathway + * Matt, our articles are written in order (ie TypeScript) + * Aviv, No group echo-ed our current Getting Started + * Brian, a "learn hub" would be really nice + * Matt, "Parent Articles" groups would be nice for grouping + * Brian, lets cut an issue for this concern + * The order of categories prioritizes categories that might not be as helpful to the reader (i.e. Test Runner should be greater than Diagnostics) + * Matt, things are teach "new" users information are more important than advanced deep-dives + * Aviv, a good first issue is to move content around + * Many articles have their own "Intro" page, maybe a general "Intro" section would be nice? + * Brian, routing page + * A lot of articles are out-of-date, which leads to incorrect content + * Aviv, a lot of articles are *old*, and are very out of date + * Brian, this is not meant to be a MDN resource + * Matt, a quick fix is to put the file change date in the frontmatter + * Brian, a semi-annual review exists. We (the Website Team) shouldn't be the reviewers, but rather delegate to working groups + * Aviv, maybe at the next summit we make the collaborators do some of this + * There is a lot of content, and it's doubtful that many users have read the entire thing. + * Aviv, some articles are **long** + * Matt, the content is _very_ useful, but it can be split up. + * Aviv, the article doesn't even mention `npm publish`. It should be it's own section + * Matt, the "TypeScript publishing" article can reference this (as a section) + * Matt, we should be a bit more opinioniated about ESM/CJS. Recommended paths and what-not. + * It would be nice to add an entire "HTTP" section, with fetch(), node:http, and the various other ways to make network requests + * New article -> New issue + + +* Add lint rule ensuring that a publishing date is valid [#7845](https://github.com/nodejs/nodejs.org/issues/7845) + * Aviv, https://github.com/nodejs/nodejs.org/pull/7838 was meant for the future, and we published it, not knowing it wasn't supposed to be published + * Brian, should the date be content-only, or should we hide posts until a given date? + * Claudio, it's fine to keep as is + * Matt, a lint rule is a solution to a problem that shouldn't be a problem + * Aviv, it's going to cause a problem for everyone with a valid blog post + * Claudio, the _max_ we should do is a CI/CD comment + * Matt, the PR had _zero_ indication of a future date, and should have + * Brian, this is an edge case, since the content was semi-embargoed. + * Matt, the author is responsible for their own date and publishing information, unless it's a repeat problem. + +### nodejs/web-team + +* Meeting with Microsoft Advisor [#53](https://github.com/nodejs/web-team/issues/53) + * Skipped, as the advisor could not join + * Aviv, I'll reach out privately and resolve the issue +* Create Means for Private Communications [#14](https://github.com/nodejs/web-team/issues/14) + * Matt, leaning toward Slack channel over repository. Do even need this? + * Brian, we really don't need this that often, and the topic specific channels work fine. + * Matt, other teams do it, but they have a lot more need than we do. + +## Q&A, Other + +* Azure Credits + * Matt, we should see what nodejs/build needs + * Claudio, we have _another_ Azure account with legacy credits, and should migrate over here. Ours are just sitting there. + * + +## Upcoming Meetings + +* **Node.js Project Calendar**: + +Click `Add to Google Calendar` at the bottom left to add to your own Google calendar. From a7086b69f178763472531b0d854581c6413e8a51 Mon Sep 17 00:00:00 2001 From: Aviv Keller Date: Mon, 27 Oct 2025 15:48:38 -0400 Subject: [PATCH 2/7] Update meetings/2025-10-27.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- meetings/2025-10-27.md | 1 - 1 file changed, 1 deletion(-) diff --git a/meetings/2025-10-27.md b/meetings/2025-10-27.md index 47a0f09..e4574a3 100644 --- a/meetings/2025-10-27.md +++ b/meetings/2025-10-27.md @@ -80,7 +80,6 @@ Extracted from **web-agenda** labelled issues and pull requests from the **nodej * Azure Credits * Matt, we should see what nodejs/build needs * Claudio, we have _another_ Azure account with legacy credits, and should migrate over here. Ours are just sitting there. - * ## Upcoming Meetings From 76024937d864c8ca3378ffd4f30b121178efaaf8 Mon Sep 17 00:00:00 2001 From: Aviv Keller Date: Mon, 27 Oct 2025 15:48:46 -0400 Subject: [PATCH 3/7] Update meetings/2025-10-27.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- meetings/2025-10-27.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/meetings/2025-10-27.md b/meetings/2025-10-27.md index e4574a3..d46a5d0 100644 --- a/meetings/2025-10-27.md +++ b/meetings/2025-10-27.md @@ -47,7 +47,7 @@ Extracted from **web-agenda** labelled issues and pull requests from the **nodej * There is a lot of content, and it's doubtful that many users have read the entire thing. * Aviv, some articles are **long** * Matt, the content is _very_ useful, but it can be split up. - * Aviv, the article doesn't even mention `npm publish`. It should be it's own section + * Aviv, the article doesn't even mention `npm publish`. It should be its own section * Matt, the "TypeScript publishing" article can reference this (as a section) * Matt, we should be a bit more opinioniated about ESM/CJS. Recommended paths and what-not. * It would be nice to add an entire "HTTP" section, with fetch(), node:http, and the various other ways to make network requests From b16d7a1f3ece5a8e457b504065dd1b650112f172 Mon Sep 17 00:00:00 2001 From: Aviv Keller Date: Mon, 27 Oct 2025 15:48:53 -0400 Subject: [PATCH 4/7] Update meetings/2025-10-27.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- meetings/2025-10-27.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/meetings/2025-10-27.md b/meetings/2025-10-27.md index d46a5d0..54701d2 100644 --- a/meetings/2025-10-27.md +++ b/meetings/2025-10-27.md @@ -49,7 +49,7 @@ Extracted from **web-agenda** labelled issues and pull requests from the **nodej * Matt, the content is _very_ useful, but it can be split up. * Aviv, the article doesn't even mention `npm publish`. It should be its own section * Matt, the "TypeScript publishing" article can reference this (as a section) - * Matt, we should be a bit more opinioniated about ESM/CJS. Recommended paths and what-not. + * Matt, we should be a bit more opinionated about ESM/CJS. Recommended paths and what-not. * It would be nice to add an entire "HTTP" section, with fetch(), node:http, and the various other ways to make network requests * New article -> New issue From 518acda20bc8959f59e93decdfe71d231503b3e0 Mon Sep 17 00:00:00 2001 From: Aviv Keller Date: Tue, 28 Oct 2025 07:51:51 -0400 Subject: [PATCH 5/7] Apply suggestion from @bmuenzenmeyer Co-authored-by: Brian Muenzenmeyer --- meetings/2025-10-27.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/meetings/2025-10-27.md b/meetings/2025-10-27.md index 54701d2..f90cc96 100644 --- a/meetings/2025-10-27.md +++ b/meetings/2025-10-27.md @@ -34,7 +34,7 @@ Extracted from **web-agenda** labelled issues and pull requests from the **nodej * Matt, "Parent Articles" groups would be nice for grouping * Brian, lets cut an issue for this concern * The order of categories prioritizes categories that might not be as helpful to the reader (i.e. Test Runner should be greater than Diagnostics) - * Matt, things are teach "new" users information are more important than advanced deep-dives + * Matt, things like teach "new" users information are more important than advanced deep-dives * Aviv, a good first issue is to move content around * Many articles have their own "Intro" page, maybe a general "Intro" section would be nice? * Brian, routing page From f34284fb6b5626b84b7cdb38203f24694511b3f2 Mon Sep 17 00:00:00 2001 From: Aviv Keller Date: Tue, 28 Oct 2025 07:52:05 -0400 Subject: [PATCH 6/7] Apply suggestion from @bmuenzenmeyer Co-authored-by: Brian Muenzenmeyer --- meetings/2025-10-27.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/meetings/2025-10-27.md b/meetings/2025-10-27.md index f90cc96..b230ffe 100644 --- a/meetings/2025-10-27.md +++ b/meetings/2025-10-27.md @@ -42,7 +42,7 @@ Extracted from **web-agenda** labelled issues and pull requests from the **nodej * Aviv, a lot of articles are *old*, and are very out of date * Brian, this is not meant to be a MDN resource * Matt, a quick fix is to put the file change date in the frontmatter - * Brian, a semi-annual review exists. We (the Website Team) shouldn't be the reviewers, but rather delegate to working groups + * Brian, a [review system is proposed](https://github.com/nodejs/nodejs.org/issues/7295). We (the Website Team) shouldn't be the reviewers, but rather delegate to working groups * Aviv, maybe at the next summit we make the collaborators do some of this * There is a lot of content, and it's doubtful that many users have read the entire thing. * Aviv, some articles are **long** From cac3ab99ab2689f1b84ceae83eb481de4647d0ec Mon Sep 17 00:00:00 2001 From: Aviv Keller Date: Tue, 28 Oct 2025 07:52:34 -0400 Subject: [PATCH 7/7] Apply suggestion from @avivkeller --- meetings/2025-10-27.md | 1 + 1 file changed, 1 insertion(+) diff --git a/meetings/2025-10-27.md b/meetings/2025-10-27.md index b230ffe..8ececc2 100644 --- a/meetings/2025-10-27.md +++ b/meetings/2025-10-27.md @@ -70,6 +70,7 @@ Extracted from **web-agenda** labelled issues and pull requests from the **nodej * Meeting with Microsoft Advisor [#53](https://github.com/nodejs/web-team/issues/53) * Skipped, as the advisor could not join * Aviv, I'll reach out privately and resolve the issue + * Create Means for Private Communications [#14](https://github.com/nodejs/web-team/issues/14) * Matt, leaning toward Slack channel over repository. Do even need this? * Brian, we really don't need this that often, and the topic specific channels work fine.