Skip to content

Commit f2c2f42

Browse files
TrottBethGriggs
authored andcommitted
doc: improve wording in deprecations.md
* utilize -> use * may -> can/might as appropriate PR-URL: #34860 Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com> Reviewed-By: Michaël Zasso <targos@protonmail.com> Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
1 parent e90cb49 commit f2c2f42

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

doc/api/deprecations.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -3,13 +3,13 @@
33
<!--introduced_in=v7.7.0-->
44
<!-- type=misc -->
55

6-
Node.js may deprecate APIs for any of the following reasons:
6+
Node.js APIs might be deprecated for any of the following reasons:
77

88
* Use of the API is unsafe.
99
* An improved alternative API is available.
1010
* Breaking changes to the API are expected in a future major release.
1111

12-
Node.js utilizes three kinds of Deprecations:
12+
Node.js uses three kinds of Deprecations:
1313

1414
* Documentation-only
1515
* Runtime
@@ -34,7 +34,7 @@ from Node.js.
3434

3535
## Revoking deprecations
3636

37-
Occasionally, the deprecation of an API may be reversed. In such situations,
37+
Occasionally, the deprecation of an API might be reversed. In such situations,
3838
this document will be updated with information relevant to the decision.
3939
However, the deprecation identifier will not be modified.
4040

@@ -1651,7 +1651,7 @@ Type: End-of-Life
16511651
Using a property named `inspect` on an object to specify a custom inspection
16521652
function for [`util.inspect()`][] is deprecated. Use [`util.inspect.custom`][]
16531653
instead. For backward compatibility with Node.js prior to version 6.4.0, both
1654-
may be specified.
1654+
can be specified.
16551655

16561656
<a id="DEP0080"></a>
16571657
### DEP0080: `path._makeLong()`
@@ -1752,7 +1752,7 @@ The `v8/*` modules do not have any exports, and if not imported in a specific
17521752
order would in fact throw errors. As such there are virtually no legitimate use
17531753
cases for importing them through `require()`.
17541754

1755-
On the other hand, `node-inspect` may be installed locally through a package
1755+
On the other hand, `node-inspect` can be installed locally through a package
17561756
manager, as it is published on the npm registry under the same name. No source
17571757
code modification is necessary if that is done.
17581758

@@ -2053,7 +2053,7 @@ Type: Documentation-only (supports [`--pending-deprecation`][])
20532053

20542054
When assigning a non-string property to [`process.env`][], the assigned value is
20552055
implicitly converted to a string. This behavior is deprecated if the assigned
2056-
value is not a string, boolean, or number. In the future, such assignment may
2056+
value is not a string, boolean, or number. In the future, such assignment might
20572057
result in a thrown error. Please convert the property to a string before
20582058
assigning it to `process.env`.
20592059

@@ -2249,7 +2249,7 @@ Type: Documentation-only (supports [`--pending-deprecation`][])
22492249
In recent versions of Node.js, there is no difference between
22502250
[`crypto.randomBytes()`][] and `crypto.pseudoRandomBytes()`. The latter is
22512251
deprecated along with the undocumented aliases `crypto.prng()` and
2252-
`crypto.rng()` in favor of [`crypto.randomBytes()`][] and may be removed in a
2252+
`crypto.rng()` in favor of [`crypto.randomBytes()`][] and might be removed in a
22532253
future release.
22542254

22552255
<a id="DEP0116"></a>
@@ -2600,7 +2600,7 @@ changes:
26002600
Type: Runtime
26012601

26022602
Allowing a [`fs.FileHandle`][] object to be closed on garbage collection is
2603-
deprecated. In the future, doing so may result in a thrown error that will
2603+
deprecated. In the future, doing so might result in a thrown error that will
26042604
terminate the process.
26052605

26062606
Please ensure that all `fs.FileHandle` objects are explicitly closed using

0 commit comments

Comments
 (0)