Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
24 commits
Select commit Hold shift + click to select a range
d9e508c
feat(blog): add What's new in Node.js 27 article
lmammino Nov 6, 2026
2b1bab8
Address review feedback for PR #42
lmammino Nov 6, 2026
453d696
Use forecast and vector examples for Iterator.zip in PR #42
lmammino Nov 7, 2026
d95448f
Add endless power-meter iterator example to PR #42
lmammino Nov 7, 2026
a89c046
Use an array for roles in zipKeyed example
lmammino Nov 7, 2026
a8ab2e0
Clarify the separate-array use case for zipKeyed
lmammino Nov 7, 2026
139328c
Split join and includes examples and clarify synchronous scope
lmammino Nov 7, 2026
002e6dc
State async iterator helper availability in Node.js 27 alpha
lmammino Nov 7, 2026
bff94c2
Add transition from iterators to numerical accuracy
lmammino Nov 7, 2026
d84195b
Explain input precision limits of Math.sumPrecise
lmammino Nov 7, 2026
c7d9589
Rename Math.sumPrecise section to reflect its accuracy benefit
lmammino Nov 7, 2026
0a0f1f3
Explain concurrency pitfalls of the TCP server iterator
lmammino Nov 7, 2026
f55f7e4
Demonstrate concurrent TCP handlers before the sequential pitfall
lmammino Nov 7, 2026
c4d25b3
Use a TCP chat server to demonstrate concurrent connection handlers
lmammino Nov 7, 2026
7ed383c
Make the TCP chat introduction more conversational
lmammino Nov 7, 2026
5fd9c05
Add screenshot of the TCP chat with three netcat clients
lmammino Nov 7, 2026
950158f
Explain VFS disposal and record resource management linking opportunity
lmammino Nov 7, 2026
8f1bf97
Link VFS disposal explanation to MDN using reference
lmammino Nov 7, 2026
3873221
Qualify production advice by the Node.js 27 alpha timeline
lmammino Nov 7, 2026
af7b22e
Correct final article details and align runnable examples
lmammino Nov 7, 2026
43316a2
Edit Node.js 27 article prose for a more natural voice
lmammino Nov 7, 2026
8f59af3
Set publication date and record article publishing checklist
lmammino Nov 7, 2026
d8d4c4d
Complete publication review and correct blog Open Graph type
lmammino Nov 7, 2026
cb4f32d
Record passing publication checks
lmammino Nov 7, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 37 additions & 0 deletions .claude/briefs/whats-new-in-nodejs-27-publishing.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# Publishing: What's new in Node.js 27

Article: `src/content/blog/whats-new-in-nodejs-27/index.md`
PR: https://github.com/nodejs-design-patterns-book/nodejsdesignpatterns.com/pull/42
Companion: https://github.com/lmammino/nodejs-27-examples
Target publication date: 7 November 2026. If publication slips, update both `date` and `updatedAt` before merging.

## Completed

- [x] Audit release claims against official sources and correct verified inaccuracies.
- [x] Run all 20 JavaScript examples on Node.js 27 alpha, including the chat integration checks.
- [x] Verify all 18 named article samples match the companion files exactly; push companion changes.
- [x] Add the TCP chat screenshot and accessible alt text.
- [x] Humanize the prose without changing code, links, metadata, or FAQ answers.
- [x] Verify FAQ parity, internal links, formatting, and the production build.
- [x] Set publication and update timestamps to 7 November 2026.

## Before publication

- [x] Review the rendered article on desktop and mobile, especially long code blocks, the chat screenshot, admonitions, and the free-chapter CTA.
- [x] Review the search/social preview. The description is 148 characters; correct blog Open Graph metadata from `book` to `article`.
- [x] Refresh PR #42's description with the final TCP chat example, qualified performance claims, and validation evidence.
- [x] Close the three rejected review threads with verified explanations (abort behavior, zip padding, and mkstemp return shape). All 12 review threads are resolved.
- [x] Confirm CI passes for the final code changes (`d8d4c4d`): lint, repository formatting, typecheck, and build. [GitHub CI result](https://github.com/nodejs-design-patterns-book/nodejsdesignpatterns.com/actions/runs/42406627985). Recheck if code changes before merging.
- [ ] Merge PR #42 into `main` when ready to publish. The push to `main` triggers the GitHub Pages deployment.

## After publication

- [ ] Confirm the GitHub Pages deployment succeeds and the article loads at https://nodejsdesignpatterns.com/blog/whats-new-in-nodejs-27/.
- [ ] Verify the live publication date, screenshot, code blocks, companion link, and free-chapter CTA. Check the blog index, RSS feed, sitemap, and structured data include the article.
- [ ] Mark the article published in `.claude/content-calendar.md` and add relevant incoming links from existing posts.
- [ ] Prepare and approve announcement copy for the channels you want to use, then share the live URL.

## Later follow-up

- [ ] When article #15b (Explicit Resource Management) is published, replace the temporary MDN link in the VFS disposal note and add the reciprocal link recorded in the content calendar.
- [ ] Revisit the article as Node.js 27 progresses through Alpha, Current in April 2027, and LTS in October 2027.
3 changes: 3 additions & 0 deletions .claude/content-calendar.md
Original file line number Diff line number Diff line change
Expand Up @@ -139,6 +139,8 @@ Path Traversal Security (NEW)
└── links to → OWASP Top 10 for Node.js (future)

Explicit Resource Management (using/await using)
└── incoming link opportunity ← What's new in Node.js 27 (VFS `using` note; add when #15b is published)
└── links to → What's new in Node.js 27 (concrete VFS disposal example)
└── links to → Reading/Writing Files (existing)
└── links to → Stream Consumer (existing)
└── links to → Async Iterators (existing)
Expand Down Expand Up @@ -191,6 +193,7 @@ Security Cluster (future)
- [x] Publish environment variables article (Core APIs pillar, #2)
- [x] Cross-link env vars article (HTTP Requests and Docker guides link to it; it links out to 6 existing articles)
- [ ] Promote env vars article (r/node, dev.to, newsletter); the "when NOT to use env vars for secrets" angle is a good hook. Drafts ready: .claude/social/nodejs-environment-variables.md (X thread + 4 standalone posts, 2 LinkedIn posts, Bluesky/Mastodon, r/node, dev.to plan, newsletter blurb, schedule)
- [ ] When publishing Explicit Resource Management (#15b), replace the temporary MDN `using` link with a link to it in the "Why does it unmount automatically?" note in `src/content/blog/whats-new-in-nodejs-27/index.md`. Link back from #15b to `/blog/whats-new-in-nodejs-27/#virtual-file-system-nodevfs-is-now-unflagged` as a practical `using` / `Symbol.dispose` example.
- [ ] Monitor keyword rankings for existing content
- [ ] A/B test CTA placements
- [ ] Promote path traversal article on security forums (r/netsec, HN)
Expand Down
4 changes: 3 additions & 1 deletion src/Layout.astro
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@ export interface Props {
title?: string
description?: string
ogTitle?: string
ogType?: string
ogDescription?: string
ogImage?: string
canonical?: string
Expand All @@ -35,6 +36,7 @@ const {
title = SITE_TITLE,
description = SITE_DESCRIPTION,
ogTitle = OG_TITLE,
ogType = OG_TYPE,
ogDescription = OG_DESCRIPTION,
ogImage = OG_IMAGE,
canonical,
Expand Down Expand Up @@ -88,7 +90,7 @@ const {
<link rel="sitemap" href="/sitemap-index.xml" />

<!-- Open Graph / Facebook -->
<meta property="og:type" content={OG_TYPE} />
<meta property="og:type" content={ogType} />
<meta property="og:url" content={canonical} />
<meta property="og:title" content={ogTitle} />
<meta property="og:description" content={ogDescription} />
Expand Down
1 change: 1 addition & 0 deletions src/components/blog/BlogLayout.astro
Original file line number Diff line number Diff line change
Expand Up @@ -80,6 +80,7 @@ if (post.rendered?.metadata?.headings) {
title={title}
description={description}
ogTitle={title}
ogType="article"
ogDescription={description}
canonical={`${SITE_URL}/blog/${post.id}/`}
additionalSchema={schemas}
Expand Down
Loading
Loading