-
Notifications
You must be signed in to change notification settings - Fork 29.6k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
doc: fix sentence fragment in fs doc #6488
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.