Skip to content

Commit 9c55970

Browse files
committed
doc: improve wording in deprecations.md
* utilize -> use * may -> can/might as appropriate PR-URL: nodejs#34860 Reviewed-By: Trivikram Kamat <[email protected]> Reviewed-By: Michaël Zasso <[email protected]> Reviewed-By: James M Snell <[email protected]> Reviewed-By: Luigi Pinca <[email protected]>
1 parent 8e8d429 commit 9c55970

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

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

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

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

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

20722072
When assigning a non-string property to [`process.env`][], the assigned value is
20732073
implicitly converted to a string. This behavior is deprecated if the assigned
2074-
value is not a string, boolean, or number. In the future, such assignment may
2074+
value is not a string, boolean, or number. In the future, such assignment might
20752075
result in a thrown error. Please convert the property to a string before
20762076
assigning it to `process.env`.
20772077

@@ -2267,7 +2267,7 @@ Type: Documentation-only (supports [`--pending-deprecation`][])
22672267
In recent versions of Node.js, there is no difference between
22682268
[`crypto.randomBytes()`][] and `crypto.pseudoRandomBytes()`. The latter is
22692269
deprecated along with the undocumented aliases `crypto.prng()` and
2270-
`crypto.rng()` in favor of [`crypto.randomBytes()`][] and may be removed in a
2270+
`crypto.rng()` in favor of [`crypto.randomBytes()`][] and might be removed in a
22712271
future release.
22722272

22732273
<a id="DEP0116"></a>
@@ -2621,7 +2621,7 @@ changes:
26212621
Type: Runtime
26222622

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

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

0 commit comments

Comments
 (0)