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

Confusing and outdated tidbit in streams documentation #55987

Closed
mscdex opened this issue Nov 24, 2024 · 0 comments · Fixed by #55988
Closed

Confusing and outdated tidbit in streams documentation #55987

mscdex opened this issue Nov 24, 2024 · 0 comments · Fixed by #55988
Labels
doc Issues and PRs related to the documentations.

Comments

@mscdex
Copy link
Contributor

mscdex commented Nov 24, 2024

Affected URL(s)

https://nodejs.org/docs/latest/api/stream.html

Description of the problem

Specifically this bit:

node/doc/api/stream.md

Lines 3849 to 3850 in b6fe731

Furthermore, the `callback` should not be mixed with async/await
once it is executed when a promise is resolved.

Since the undocumented support for "thenables" was removed starting with v18.0.0, this bit in the streams documentation is outdated and should be removed.

@mscdex mscdex added the doc Issues and PRs related to the documentations. label Nov 24, 2024
lpinca added a commit to lpinca/node that referenced this issue Nov 25, 2024
Remove confusing and outdated sentence in `doc/api/stream.md`.

Fixes: nodejs#55987
targos pushed a commit that referenced this issue Dec 2, 2024
Remove confusing and outdated sentence in `doc/api/stream.md`.

Fixes: #55987
PR-URL: #55988
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com>
Reviewed-By: Jason Zhang <xzha4350@gmail.com>
Reviewed-By: LiviaMedeiros <livia@cirno.name>
Reviewed-By: Jake Yuesong Li <jake.yuesong@gmail.com>
github-actions bot pushed a commit to aduh95/node that referenced this issue Dec 4, 2024
Remove confusing and outdated sentence in `doc/api/stream.md`.

Fixes: nodejs#55987
PR-URL: nodejs#55988
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com>
Reviewed-By: Jason Zhang <xzha4350@gmail.com>
Reviewed-By: LiviaMedeiros <livia@cirno.name>
Reviewed-By: Jake Yuesong Li <jake.yuesong@gmail.com>
aduh95 pushed a commit to aduh95/node that referenced this issue Dec 4, 2024
Remove confusing and outdated sentence in `doc/api/stream.md`.

Fixes: nodejs#55987
PR-URL: nodejs#55988
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com>
Reviewed-By: Jason Zhang <xzha4350@gmail.com>
Reviewed-By: LiviaMedeiros <livia@cirno.name>
Reviewed-By: Jake Yuesong Li <jake.yuesong@gmail.com>
aduh95 pushed a commit to aduh95/node that referenced this issue Dec 4, 2024
Remove confusing and outdated sentence in `doc/api/stream.md`.

Fixes: nodejs#55987
PR-URL: nodejs#55988
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com>
Reviewed-By: Jason Zhang <xzha4350@gmail.com>
Reviewed-By: LiviaMedeiros <livia@cirno.name>
Reviewed-By: Jake Yuesong Li <jake.yuesong@gmail.com>
aduh95 pushed a commit to aduh95/node that referenced this issue Dec 4, 2024
Remove confusing and outdated sentence in `doc/api/stream.md`.

Fixes: nodejs#55987
PR-URL: nodejs#55988
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com>
Reviewed-By: Jason Zhang <xzha4350@gmail.com>
Reviewed-By: LiviaMedeiros <livia@cirno.name>
Reviewed-By: Jake Yuesong Li <jake.yuesong@gmail.com>
aduh95 pushed a commit to aduh95/node that referenced this issue Dec 4, 2024
Remove confusing and outdated sentence in `doc/api/stream.md`.

Fixes: nodejs#55987
PR-URL: nodejs#55988
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com>
Reviewed-By: Jason Zhang <xzha4350@gmail.com>
Reviewed-By: LiviaMedeiros <livia@cirno.name>
Reviewed-By: Jake Yuesong Li <jake.yuesong@gmail.com>
aduh95 pushed a commit to aduh95/node that referenced this issue Dec 4, 2024
Remove confusing and outdated sentence in `doc/api/stream.md`.

Fixes: nodejs#55987
PR-URL: nodejs#55988
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com>
Reviewed-By: Jason Zhang <xzha4350@gmail.com>
Reviewed-By: LiviaMedeiros <livia@cirno.name>
Reviewed-By: Jake Yuesong Li <jake.yuesong@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
doc Issues and PRs related to the documentations.
Projects
None yet
Development

Successfully merging a pull request may close this issue.

1 participant