Firstly this is not a rant. I just want to know if its a community decision to have docs this way or there is opportunity for me to contribute to make documentation better.

I am a new to nodejs and i find the nodejs.org/.../docs are very less informative compared to any other big OSS platforms.

for example fs.close api doc is very vague for me.

• Its just listing the arguments fd and callback.
• It would be great to know if the callback has arguments and their details.
• I would want to have an example associated with it.

Can you share thoughts on this perspective, is there any ongoing effort in this area?