doc: Provide bad/better examples for access() and exists()#7832
doc: Provide bad/better examples for access() and exists()#7832dfabulich wants to merge 1 commit intonodejs:masterfrom
Conversation
nodejs-github-bot
added
doc
doc/api/fs.md
Outdated
There was a problem hiding this comment.
As opposed to saying should not be used, perhaps something a bit softer...
Using `fs.acess()` to check for the existence of a file before calling `fs.open()`,
`fs.readFile()`, or `fs.writeFile()` is not recommended because doing so...
|
Thank you for this, left some comments! Sorry it has take so long for someone to take a look and get back to you. |
dfabulich
force-pushed
the
exists-access-examples
branch
from
c3c11b3 to
ccec465
Compare
|
@jasnell Thanks for your feedback. I've incorporated your comments in the latest draft. |
|
@dfabulich .. thank you! will be able to go through in detail again tomorrow :-) |
|
ping @jasnell |
|
Whoops, let this one slip off my radar. LGTM |
|
ping @nodejs/documentation |
doc/api/fs.md
Outdated
There was a problem hiding this comment.
Maybe split the code blocks and put these pseudo-headings in bold just above them?
|
LGTM with a suggestion, thanks for putting these together! |
doc/api/fs.md
Outdated
There was a problem hiding this comment.
Drop the else, we can unindent the next function call.
dfabulich
force-pushed
the
exists-access-examples
branch
from
ccec465 to
80d6ec3
Compare
|
Incorporated feedback from @addaleax and @thefourtheye |
|
LGTM! will get this landed! |
PR-URL: #7832 Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Anna Henningsen <anna@addaleax.net>
|
Landed in 143d38c. Thank you! |
PR-URL: nodejs#7832 Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Anna Henningsen <anna@addaleax.net>
PR-URL: #7832 Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Anna Henningsen <anna@addaleax.net>
PR-URL: #7832 Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Anna Henningsen <anna@addaleax.net>
|
I've landed this on v4.x-staging as it appears to be accurate. Please let me know if it is not |
PR-URL: #7832 Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Anna Henningsen <anna@addaleax.net>
PR-URL: #7832 Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Anna Henningsen <anna@addaleax.net>
PR-URL: #7832 Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Anna Henningsen <anna@addaleax.net>
7 participants
Checklist
make -j4 test(UNIX), orvcbuild test nosign(Windows) passesAffected core subsystem(s)
doc
Description of change