Skip to content

doc: clarify selected API behavior#63317

Open
MukundaKatta wants to merge 1 commit into
nodejs:mainfrom
MukundaKatta:codex/node-docs-sea-statfs
Open

doc: clarify selected API behavior#63317
MukundaKatta wants to merge 1 commit into
nodejs:mainfrom
MukundaKatta:codex/node-docs-sea-statfs

Conversation

@MukundaKatta
Copy link
Copy Markdown

Summary

  • Clarify selected API docs

Changed files

  • doc/api/fs.md
  • doc/api/globals.md
  • doc/api/packages.md

Tests

  • Not run in this publishing pass.

@nodejs-github-bot
Copy link
Copy Markdown
Collaborator

Review requested:

  • @nodejs/loaders

@nodejs-github-bot nodejs-github-bot added the doc Issues and PRs related to the documentations. label May 15, 2026
@MukundaKatta MukundaKatta changed the title [codex] Clarify selected API docs doc: clarify selected API behavior May 15, 2026
@MukundaKatta MukundaKatta marked this pull request as ready for review May 15, 2026 02:58
Comment thread doc/api/packages.md
Comment on lines +723 to +728
If a package wants to avoid the dual package hazard in Node.js while still
providing an ES module build for non-Node.js environments, consider using
`"node"` and `"default"` conditions instead. For example, the `"node"`
condition can point to a single CommonJS implementation for Node.js, while the
`"default"` condition points to an ES module implementation for browsers or
other JavaScript runtimes.
Copy link
Copy Markdown
Member

@GeoffreyBooth GeoffreyBooth May 15, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why is this being added? This should be its own PR.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1, this PR should be split in 3

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

doc Issues and PRs related to the documentations.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants