Skip to content
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

Closed
wants to merge 1 commit into from

Conversation

jasnell
Copy link
Member

@jasnell jasnell commented Dec 26, 2015

Several improvements including a few new examples

@jasnell jasnell added doc Issues and PRs related to the documentations. console Issues and PRs related to the console subsystem. labels Dec 26, 2015
@@ -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.
Copy link
Member

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.)

@jasnell
Copy link
Member Author

jasnell commented Dec 27, 2015

@Trott ... fixed!

@Qard
Copy link
Member

Qard commented Dec 29, 2015

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
Copy link
Contributor

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.

Copy link
Contributor

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.

@cjihrig
Copy link
Contributor

cjihrig commented Dec 29, 2015

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
Copy link
Contributor

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"?

@evanlucas
Copy link
Contributor

Left a few comments and LGTM

Several improvements including a few new examples
@jasnell jasnell force-pushed the doc-console-improvements branch from 249461b to 36766ff Compare December 30, 2015 18:41
@jasnell
Copy link
Member Author

jasnell commented Dec 30, 2015

@evanlucas ... nits addressed

jasnell added a commit that referenced this pull request Dec 30, 2015
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>
@jasnell
Copy link
Member Author

jasnell commented Dec 30, 2015

Landed in e4c835e

@jasnell jasnell closed this Dec 30, 2015
Fishrock123 pushed a commit to Fishrock123/node that referenced this pull request Jan 6, 2016
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>
jasnell added a commit that referenced this pull request Jan 7, 2016
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>
@MylesBorins
Copy link
Contributor

Added to LTS with minor edits to the console.time copy

MylesBorins pushed a commit that referenced this pull request Jan 19, 2016
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>
@MylesBorins MylesBorins mentioned this pull request Jan 19, 2016
scovetta pushed a commit to scovetta/node that referenced this pull request Apr 2, 2016
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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
console Issues and PRs related to the console subsystem. doc Issues and PRs related to the documentations.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants