Skip to content

rephrase API docs in tracing.md - #35556

Merged
Trott merged 1 commit into
nodejs:masterfrom
PoojaDurgad:api-version
Oct 10, 2020
Merged

rephrase API docs in tracing.md#35556
Trott merged 1 commit into
nodejs:masterfrom
PoojaDurgad:api-version

Conversation

@PoojaDurgad

Copy link
Copy Markdown
Contributor
Checklist
  • make -j4 test (UNIX), or vcbuild test (Windows) passes
  • tests and/or benchmarks are included
  • documentation is changed or added
  • commit message follows commit guidelines

@nodejs-github-botnodejs-github-bot added the doc Issues and PRs related to the documentations. label Oct 8, 2020
Comment threaddoc/api/tracing.md Outdated

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We avoid the v prefix in prose, see https://github.com/nodejs/node/blob/master/doc/guides/doc-style-guide.md.

  • When referring to a version of Node.js in prose, use Node.js and the version
    number. Do not prefix the version number with v in prose. This is to avoid
    confusion about whether v8 refers to Node.js 8.x or the V8 JavaScript
    engine.
    • OK: Node.js 14.x, Node.js 14.3.1
    • NOT OK: Node.js v14

Comment threaddoc/api/tracing.md Outdated
Comment on lines 83 to 86

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The addition of v here violates our style guide as noted by @richardlau above. However, the text here could stand some other improvements:

  • Might be a good idea to remove "Starting with Node.js 10.0.0". These docs are for a specific version of Node.js.
  • The sentence is a run-on sentence. It would be better split into two sentences.
Suggested change
Starting with Node.js v10.0.0, the tracing system uses the same time source
as the one used by `process.hrtime()`
however the trace-event timestamps are expressed in microseconds,
unlike `process.hrtime()` which returns nanoseconds.
The tracing system uses the same time source
as the one used by `process.hrtime()`.
However the trace-event timestamps are expressed in microseconds,
unlike `process.hrtime()` which returns nanoseconds.

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Trott - thanks for the review, I understand. I have followed your suggestions. Please have a look.

@TrottTrott left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@PoojaDurgadPoojaDurgad changed the title doc: In tracing.md the statement Node.js 10.0.0 is modified to Node.js v10.0.0rephrase API docs in tracing.mdOct 8, 2020
PR-URL: nodejs#35556
Reviewed-By: Harshitha K P <harshitha014@gmail.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
@Trott

Copy link
Copy Markdown
Member

Landed in ff4928f

@Trott
Trott merged commit ff4928f into nodejs:masterOct 10, 2020
MylesBorins pushed a commit that referenced this pull request Oct 14, 2020
PR-URL: #35556
Reviewed-By: Harshitha K P <harshitha014@gmail.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
@MylesBorinsMylesBorins mentioned this pull request Oct 14, 2020
MylesBorins pushed a commit that referenced this pull request Nov 3, 2020
PR-URL: #35556
Reviewed-By: Harshitha K P <harshitha014@gmail.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
@MylesBorinsMylesBorins mentioned this pull request Nov 3, 2020
MylesBorins pushed a commit that referenced this pull request Nov 16, 2020
PR-URL: #35556
Reviewed-By: Harshitha K P <harshitha014@gmail.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
joesepi pushed a commit to joesepi/node that referenced this pull request Jan 8, 2021
PR-URL: nodejs#35556
Reviewed-By: Harshitha K P <harshitha014@gmail.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docIssues and PRs related to the documentations.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

@PoojaDurgad@Trott@richardlau@HarshithaKP@nodejs-github-bot