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

doc: add readable and writable property to Readable and Writable #23924

Closed

Conversation

dexterleng
Copy link
Contributor

@dexterleng dexterleng commented Oct 27, 2018

Issue #21431

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. stream Issues and PRs related to the stream subsystem. labels Oct 27, 2018
added: REPLACEME
-->

* Returns: {boolean}
Copy link
Member

Choose a reason for hiding this comment

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

It's a property, not a function, so it does not return a value.

added: REPLACEME
-->

* Returns: {boolean}
Copy link
Member

Choose a reason for hiding this comment

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

It's a property, not a function, so it does not return a value.

@@ -482,6 +482,16 @@ This property contains the number of bytes (or objects) in the queue
ready to be written. The value provides introspection data regarding
the status of the `highWaterMark`.

##### writable.writable
<!-- YAML>
Copy link
Member

Choose a reason for hiding this comment

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

Remove >

@@ -1034,6 +1044,15 @@ This property contains the number of bytes (or objects) in the queue
ready to be read. The value provides introspection data regarding
the status of the `highWaterMark`.

##### readable.readable
<!-- YAML>
Copy link
Member

Choose a reason for hiding this comment

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

Remove >

@@ -482,6 +482,16 @@ This property contains the number of bytes (or objects) in the queue
ready to be written. The value provides introspection data regarding
the status of the `highWaterMark`.

##### writable.writable
Copy link
Member

Choose a reason for hiding this comment

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

Properties should be ordered alphabetically in the docs, so this is in the wrong place. It needs to appear above the other writable.writable* properties.

@@ -1034,6 +1044,15 @@ This property contains the number of bytes (or objects) in the queue
ready to be read. The value provides introspection data regarding
the status of the `highWaterMark`.

##### readable.readable
Copy link
Member

Choose a reason for hiding this comment

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

Properties should be ordered alphabetically in the docs, so this is in the wrong place. It needs to appear above the other readable.readable* properties.

@Trott
Copy link
Member

Trott commented Oct 27, 2018

Hi, @dexterleng! Welcome and thanks for the pull request! Documentation changes can attract a lot of comments, which sometimes surprises and even frustrates people. Try to be patient and to not get discouraged. Thanks again!

@dexterleng dexterleng closed this Oct 28, 2018
@dexterleng dexterleng force-pushed the add-doc-readable-writable-props branch from c0cd519 to 35ed66c Compare October 28, 2018 03:50
@dexterleng
Copy link
Contributor Author

Oops. I forced pushed and broke the commit history. Opening a new PR.

@dexterleng
Copy link
Contributor Author

#23933

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