Feedback: /runtime/fundamentals/node/ - Needs Improvement #2684
Description
Documentation Feedback
Path: /runtime/fundamentals/node/
Helpful: No ❌
Feedback:
I think this page is overally very technical for the average user. It goes deep into "how Deno does things" instead of "how to do things with Deno". For example, it's not clear to me at first glace if I can run a .cjs file in Deno.
The Using npm packages section should mention first-class package.json support.
The CommonJS support section is a bit verbose. It would help a lot if the first sentence was: "Deno supports CommonJS modules by default" instead of "How we firmly support ESM". I would actually just delete the first para and keep "Use .cjs extension" as the first thing.
A simple deno -A main.cjs code block after the express example in the "Use .cjs extension" section would clarify my doubt about running .cjs.
I think the Node.js global objects section should be placed earlier in the page since it is the only section that shows how to use Node.js runtime APIs.
GitHub User: @littledivy
This issue was automatically created from the documentation feedback system.