Node.js' insistence on being familiar to Unix people has hurt its developer experience more than they realize. Even after this many years, the docs are still subpar. Docs for `fs.mkdir` only says: `Asynchronous mkdir(2)` You shouldn't have to be Unix graybeard to use Node.js.
`mkdir(2)` does link to the Linux kernel man pages, but you shouldn't have to read Linux kernel docs to use Node.js.
When Apple has better API docs something is seriously wrong: developer.apple.com/documentation/… And a more intuitive method name.
So much resistance to improve the behavior and docs too:
github.com/nodejs/node/is…
github.com/nodejs/node/is…
github.com/nodejs/node/is…
github.com/nodejs/node/is…
github.com/nodejs/node/is…
github.com/nodejs/node/is…
If I had time, I would create a user-friendly API layer upon Node.js core. For example: `fs.createDirectory()` instead of `fs.mkdir()`, with great docs, examples, best practices, etc. The Node.js APIs are good, they're just too low-level and not dev friendly for common use.
I would be more than happy to help out improve the docs if I don't have to fight for every little docs improvement.
Even Rust, which is a low-level systems language, has more user-friendly API docs and method names. Example: doc.rust-lang.org/std/fs/fn.crea…
