doc: explicitly mention that the explanation of an synchronous fs API live in the docs of the async API

[joyeecheung]

• Version: master
• Subsystem: fs, doc

In a lot of cases, the documentation of a synchronous fs API only links to the aysnc version of that API in order to reduce duplicated texts.

For example, fs.readSync() only mentions

Synchronous version of fs.read(). Returns the number of bytesRead.

Which could be confusing to beginners since it does not explicitly mention that if they want to see a detailed explanation of the arguments, they should click the link of fs.read(). It would be more friendly if, for example, in the fs.readSync() docs we explicitly say:

Synchronous version of fs.read(). Returns the number of bytesRead.

For detailed information, see the documentation of fs.read().

And do the same for other fs.*Sync APIs if applicable.

Refs: #21193

[iwko]

@joyeecheung May I take this one?

[joyeecheung]

@iwko Sure, go ahead!

[BeniCheni]

Since didn't see any open PR fo 15 days from last comment so I opened #21479 to try this "good first issue" labeled issue. Thanks for your time to review.

[TimothyGu]

@BeniCheni, hmm, did you see #21243 (linked above by GitHub automatically)?

[BeniCheni]

Sorry about missing #21243. Closed my own duplicated PR.

[lirantal]

@joyeecheung seems like we can close this issue having @iwko's PR landed already, unless there are other areas we want to make the change in...?

What do you think about zlib? the section for all the methods do specify the connection between the sync and async version of them here: https://nodejs.org/api/zlib.html#zlib_convenience_methods

[adarshsaraogi]

Can i work on this issue

[iwko]

@adarshsaraogi this issue is alread resolved and merged

[Trott]

(As always, if I'm closing in error, please comment or re-open. Thanks.)