FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

docs: remove http streams from the list of writeables by just-boris · Pull Request #30217 · nodejs/node · GitHub

/ node Public

docs: remove http streams from the list of writeables - #30217

Closed
just-boris wants to merge 1 commit into
nodejs:masterfrom
just-boris:patch-1
Closed

docs: remove http streams from the list of writeables#30217
just-boris wants to merge 1 commit into
nodejs:masterfrom
just-boris:patch-1

Conversation

just-boris commented Nov 2, 2019
edited
Loading

Copy link
Copy Markdown

The documentation lists HTTP server response and HTTP client request as writable streams. However, in fact, they are not, which confuses users. Example in this twitter thread: https://mobile.twitter.com/getify/status/1190456439996854273

I have checked other examples, they all extend stream.Writable, so they are fine to stay in the list.

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-bot added doc Issues and PRs related to the documentations. stream Issues and PRs related to the stream subsystem. labels Nov 2, 2019

Copy link
Copy Markdown
Member

@just-boris So … while this is technically true, removing them is not helpful imo, because they largely implement the Writable interface, even without inheriting from it.

The issue referenced in the tweet has been addressed in #29053.

If you do want to fix the documentation here, I’d prefer adding notes that these streams don’t strictly inherit from Writable.

Copy link
Copy Markdown
Author

If the original issue has been solved, I'd rather close this PR

just-boris closed this Dec 1, 2019
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
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. stream Issues and PRs related to the stream subsystem.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants


Back | FazBrowse Home | New Git URL