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

doc: improve child_process `maxBuffer` text by Trott · Pull Request #11791 · nodejs/node · GitHub

/ node Public

doc: improve child_process maxBuffer text - #11791

Closed
Trott wants to merge 1 commit into
nodejs:masterfrom
Trott:maxbuffer-edit
Closed

doc: improve child_process maxBuffer text#11791
Trott wants to merge 1 commit into
nodejs:masterfrom
Trott:maxbuffer-edit

Conversation

Trott commented Mar 10, 2017

Copy link
Copy Markdown
Member

maxBuffer information in child_process.md used atypical formatting.
This uses a single consistent style for all instances of maxBuffer
information.

Checklist
  • documentation is changed or added
  • commit message follows commit guidelines
Affected core subsystem(s)

doc child_process

Trott added child_process Issues and PRs related to the child_process subsystem. doc Issues and PRs related to the documentations. labels Mar 10, 2017
nodejs-github-bot added child_process Issues and PRs related to the child_process subsystem. doc Issues and PRs related to the documentations. labels Mar 10, 2017
Comment thread doc/api/child_process.md Outdated

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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

typo: exceede

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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

Fixed, thanks!

Trott commented Mar 10, 2017
edited
Loading

Copy link
Copy Markdown
Member Author

A key thing this fixes is the confusing alternate formatting for maxBuffer in the doc which you can see here:



Because it's a link, maxBuffer is formatted differently than shell, timeout, uid, gid...

The link isn't to full information about maxBuffer so it's a bit misleading. It's a special note about maxBuffer and Unicode. So this PR moves the link out of that list and into the descriptive text, and makes it clear that it's a note and not key information. The note basically reminds people that a character can be more than one byte.

`maxBuffer` information in child_process.md used atypical formatting.
This uses a single consistent style for all instances of `maxBuffer`
information.
Trott added a commit to Trott/io.js that referenced this pull request Mar 13, 2017
`maxBuffer` information in child_process.md used atypical formatting.
This uses a single consistent style for all instances of `maxBuffer`
information.

PR-URL: nodejs#11791
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>

Trott commented Mar 13, 2017

Copy link
Copy Markdown
Member Author

Landed in ea5a2f4

Trott closed this Mar 13, 2017
italoacasas pushed a commit to italoacasas/node that referenced this pull request Mar 14, 2017
`maxBuffer` information in child_process.md used atypical formatting.
This uses a single consistent style for all instances of `maxBuffer`
information.

PR-URL: nodejs#11791
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
jungx098 pushed a commit to jungx098/node that referenced this pull request Mar 21, 2017
`maxBuffer` information in child_process.md used atypical formatting.
This uses a single consistent style for all instances of `maxBuffer`
information.

PR-URL: nodejs#11791
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>

Copy link
Copy Markdown
Contributor

is this applicable to v6.x?

Trott commented Apr 18, 2017

Copy link
Copy Markdown
Member Author

@MylesBorins It's a style change, not a content change, so I think the answer is "yes, but it's also not crucial by any stretch".

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

child_process Issues and PRs related to the child_process subsystem. doc Issues and PRs related to the documentations.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants


Back | FazBrowse Home | New Git URL