Skip to content

doc: improve net docs#32811

Closed
ronag wants to merge 7 commits into
nodejs:masterfrom
nxtedition:net-docs
Closed

doc: improve net docs#32811
ronag wants to merge 7 commits into
nodejs:masterfrom
nxtedition:net-docs

Conversation

@ronag

@ronag ronag commented Apr 13, 2020

Copy link
Copy Markdown
Member

Clarify destroy behaviour and refer back to streams docs for further and more accurate
description of behavior details.

Refs: #31916

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 nodejs-github-bot added doc Issues and PRs related to the documentations. net Issues and PRs related to the net subsystem. labels Apr 13, 2020
@ronag

ronag commented Apr 13, 2020

Copy link
Copy Markdown
Member Author

@mcollina What is your opinion on rather than duplicating docs (which over time might end up being inconsistent or outdated) we just refer to the stream docs?

e.g.

See, [writable.destroy()][] for further details.

Refer back to streams docs for further and more accurate
description of behavior details.

Refs: nodejs#31916
Comment thread doc/api/net.md Outdated
Comment thread doc/api/net.md Outdated
Comment thread doc/api/net.md Outdated

@mcollina mcollina left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

@ronag ronag added the author ready PRs that have at least one approval, no pending requests for changes, and a CI started. label Apr 13, 2020
@nodejs-github-bot

This comment has been minimized.

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Comment thread doc/api/net.md Outdated
@ronag

This comment has been minimized.

Comment thread doc/api/net.md Outdated
Ensures that no more I/O activity happens on this socket. Only necessary in
case of errors (parse error or so).
Ensures that no more I/O activity happens on this socket. This destroys
the stream but does not explicitly cause a TCP stream reset (RST).

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@lpinca: please note updated version, better?

@lpinca lpinca Apr 13, 2020

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would honestly not add those details that I think are confusing for most users. "Destroys the stream and closes the connection" is enough. Interested users can dig by themselves to see what happens under the hood.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changed to your suggestion.

Comment thread doc/api/net.md Outdated
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

ronag added a commit that referenced this pull request Apr 15, 2020
Refer back to streams docs for further and more accurate
description of behavior details.

Refs: #31916

PR-URL: #32811
Reviewed-By: Anna Henningsen <[email protected]>
Reviewed-By: Matteo Collina <[email protected]>
Reviewed-By: Luigi Pinca <[email protected]>
Reviewed-By: Denys Otrishko <[email protected]>
@ronag

ronag commented Apr 15, 2020

Copy link
Copy Markdown
Member Author

Landed in 9534458

@ronag ronag closed this Apr 15, 2020
MylesBorins pushed a commit that referenced this pull request Apr 17, 2020
Refer back to streams docs for further and more accurate
description of behavior details.

Refs: #31916

PR-URL: #32811
Reviewed-By: Anna Henningsen <[email protected]>
Reviewed-By: Matteo Collina <[email protected]>
Reviewed-By: Luigi Pinca <[email protected]>
Reviewed-By: Denys Otrishko <[email protected]>
targos pushed a commit to targos/node that referenced this pull request Apr 25, 2020
Refer back to streams docs for further and more accurate
description of behavior details.

Refs: nodejs#31916

PR-URL: nodejs#32811
Reviewed-By: Anna Henningsen <[email protected]>
Reviewed-By: Matteo Collina <[email protected]>
Reviewed-By: Luigi Pinca <[email protected]>
Reviewed-By: Denys Otrishko <[email protected]>
BridgeAR pushed a commit that referenced this pull request Apr 28, 2020
Refer back to streams docs for further and more accurate
description of behavior details.

Refs: #31916

PR-URL: #32811
Reviewed-By: Anna Henningsen <[email protected]>
Reviewed-By: Matteo Collina <[email protected]>
Reviewed-By: Luigi Pinca <[email protected]>
Reviewed-By: Denys Otrishko <[email protected]>
@BridgeAR BridgeAR mentioned this pull request Apr 28, 2020
targos pushed a commit that referenced this pull request Apr 28, 2020
Refer back to streams docs for further and more accurate
description of behavior details.

Refs: #31916

PR-URL: #32811
Reviewed-By: Anna Henningsen <[email protected]>
Reviewed-By: Matteo Collina <[email protected]>
Reviewed-By: Luigi Pinca <[email protected]>
Reviewed-By: Denys Otrishko <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author ready PRs that have at least one approval, no pending requests for changes, and a CI started. doc Issues and PRs related to the documentations. net Issues and PRs related to the net subsystem.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants