-
Notifications
You must be signed in to change notification settings - Fork 30k
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: improvements to console.markdown copy #4428
Conversation
@@ -2,29 +2,79 @@ | |||
|
|||
Stability: 2 - Stable | |||
|
|||
The module defines a `Console` class and exports a `console` object. | |||
The `console` module provides a simple debugging console that is similar, but | |||
not identical to the JavaScript console mechanism provided by Web browsers. |
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.
Nit: is similar to the JavaScript console mechanism provided by web browsers.
No need to say but not identical
as that is what similar
means.
If you do keep but not identical1
, please add a comma after identical
.
Also: web
rather than Web
. Most style guides no longer favor capitalizing Web
as far as I know. (Internet
vs. internet
is a different story.)
@Trott ... fixed! |
LGTM |
@@ -2,29 +2,79 @@ | |||
|
|||
Stability: 2 - Stable | |||
|
|||
The module defines a `Console` class and exports a `console` object. | |||
The `console` module provides a simple debugging console that is similar to the |
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.
It might be useful to say "similar, but not identical to" as we get a decent number of requests for console features that browsers have.
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.
Heh, I see that you covered that topic a little further down.
LGTM |
For ease of use, `console` is defined as a global object and can be used | ||
directly without `require`. | ||
Typically, the distinction between blocking/non-blocking is not important | ||
unless an application is logging significant amounts to data. High volume |
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.
should this be "significant amounts of data"?
Left a few comments and LGTM |
Several improvements including a few new examples
249461b
to
36766ff
Compare
@evanlucas ... nits addressed |
Several improvements including a few new examples PR-URL: #4428 Reviewed-By: Stephen Belanger <admin@stephenbelanger.com> Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: Evan Lucas <evanlucas@me.com>
Landed in e4c835e |
Several improvements including a few new examples PR-URL: nodejs#4428 Reviewed-By: Stephen Belanger <admin@stephenbelanger.com> Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: Evan Lucas <evanlucas@me.com>
Several improvements including a few new examples PR-URL: #4428 Reviewed-By: Stephen Belanger <admin@stephenbelanger.com> Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: Evan Lucas <evanlucas@me.com>
Added to LTS with minor edits to the |
Several improvements including a few new examples PR-URL: #4428 Reviewed-By: Stephen Belanger <admin@stephenbelanger.com> Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: Evan Lucas <evanlucas@me.com>
Several improvements including a few new examples PR-URL: nodejs#4428 Reviewed-By: Stephen Belanger <admin@stephenbelanger.com> Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: Evan Lucas <evanlucas@me.com>
Several improvements including a few new examples