-
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: add quotes for event names + fix similar nits #19915
Conversation
сс @nodejs/documentation, @Trott |
doc/api/inspector.md
Outdated
@@ -165,8 +165,8 @@ session.post('Profiler.enable', () => { | |||
``` | |||
|
|||
|
|||
[`session.connect()`]: #inspector_session_connect | |||
[`Debugger.paused`]: https://chromedevtools.github.io/devtools-protocol/v8/Debugger/#event-paused | |||
[`'Debugger.paused'`]: https://chromedevtools.github.io/devtools-protocol/v8/Debugger/#event-paused |
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: The link seems to be dead.
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.
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.
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.
Weird... I've refreshed with cache bypass, URLs seem identical. What can be wrong?
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.
What about this one (without the last slash):
https://chromedevtools.github.io/devtools-protocol/v8/Debugger#event-paused
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.
That works.
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.
Changed in the fixup commit.
doc/api/util.md
Outdated
@@ -144,7 +144,7 @@ exports.obsoleteFunction = util.deprecate(() => { | |||
``` | |||
|
|||
When called, `util.deprecate()` will return a function that will emit a | |||
`DeprecationWarning` using the `process.on('warning')` event. The warning will | |||
`DeprecationWarning` using the `'warning'` event. The warning will |
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: should we link 'warning'
? Otherwise it's not clear what is the target object.
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.
Done in the fixup commit.
Rebased. |
Landed in 9c8857d |
PR-URL: #19915 Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: James M Snell <[email protected]> Reviewed-By: Trivikram Kamat <[email protected]>
PR-URL: #19915 Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: James M Snell <[email protected]> Reviewed-By: Trivikram Kamat <[email protected]>
PR-URL: nodejs#19915 Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: James M Snell <[email protected]> Reviewed-By: Trivikram Kamat <[email protected]>
Checklist
make -j4 test
(UNIX), orvcbuild test
(Windows) passesI've tried to process all the patterns I could think of to unify event name mentions so that they always would be wrapped in a
`'name'`
way.During the overhaul, I've found some other nits and fixed them in passing:
''
around other string values;''
around other non-string values;`unref`d
instead of`unref`ed
);'end'
event for readable stream instead of'finish'
event);process.on('message')
event" instead of just "'message'
event");These small changes can distract during reviews, but creating many PRs just for them seems to be an even bigger burden.