-
-
Notifications
You must be signed in to change notification settings - Fork 31.5k
doc: fix sentence fragment in fs doc #6488
New issue
Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? # to your account
Conversation
@@ -797,8 +797,8 @@ the end of the file. | |||
|
|||
_Note: The behavior of `fs.open()` is platform specific for some flags. As such, | |||
opening a directory on OS X and Linux with the `'a+'` flag - see example below - | |||
will return an error. Whereas on Windows and FreeBSD a file descriptor will be |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'd just s/error. Whereas/error, whereas/
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I considered that, but then you have a fairly long sentence that is probably harder to understand than the two separate sentences:
As such, opening a directory on OS X and Linux with the
'a+'
flag - see example below - will return an error, whereas on Windows and FreeBSD a file descriptor will be returned.
I could be persuaded, but I do prefer splitting that into two sentences. The see example below
in the middle of the long sentence is especially kind of begging for a shorter sentence.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
either way works for me.
small nit, but LGTM |
LGTM |
LGTM |
PR-URL: #6488 Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com> Reviewed-By: Alexander Makarenko <estliberitas@gmail.com>
Landed in 9f8d0ea |
PR-URL: #6488 Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com> Reviewed-By: Alexander Makarenko <estliberitas@gmail.com>
PR-URL: nodejs#6488 Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com> Reviewed-By: Alexander Makarenko <estliberitas@gmail.com>
Checklist
Affected core subsystem(s)
doc
Description of change
Edit a sentence fragment so that it is a complete sentence.