Skip to content

Commit

Permalink
doc: wrap and punctuate YAML description text
Browse files Browse the repository at this point in the history
stream.md was the only YAML in doc/api that was using `>` for line
continuation, and only used it for a few descriptions, most used the
same wrapping style the rest of the documentation does.

Also added punctuation and capitialization to a few description
sentences.

Fixes: #25413 (comment)

PR-URL: #25419
Fixes: #25413
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com>
Reviewed-By: Richard Lau <riclau@uk.ibm.com>
  • Loading branch information
sam-github authored and addaleax committed Jan 14, 2019
1 parent 8380bd4 commit f58b530
Showing 1 changed file with 9 additions and 12 deletions.
21 changes: 9 additions & 12 deletions doc/api/stream.md
Original file line number Diff line number Diff line change
Expand Up @@ -788,9 +788,8 @@ added: v0.9.4
changes:
- version: v10.0.0
pr-url: https://github.com/nodejs/node/pull/17979
description: >
The `'readable'` is always emitted in the next tick after `.push()`
is called
description: The `'readable'` is always emitted in the next tick after
`.push()` is called.
- version: v10.0.0
pr-url: https://github.com/nodejs/node/pull/18994
description: Using `'readable'` requires calling `.read()`.
Expand Down Expand Up @@ -1510,13 +1509,12 @@ constructor and implement the `writable._write()` method. The
changes:
- version: v10.0.0
pr-url: https://github.com/nodejs/node/pull/18438
description: >
Add `emitClose` option to specify if `'close'` is emitted on destroy
description: Add `emitClose` option to specify if `'close'` is emitted on
destroy.
- version: v11.2.0
pr-url: https://github.com/nodejs/node/pull/22795
description: >
Add `autoDestroy` option to automatically `destroy()` the stream
when it emits `'finish'` or errors
description: Add `autoDestroy` option to automatically `destroy()` the
stream when it emits `'finish'` or errors.
-->

* `options` {Object}
Expand Down Expand Up @@ -1782,9 +1780,8 @@ constructor and implement the `readable._read()` method.
changes:
- version: v11.2.0
pr-url: https://github.com/nodejs/node/pull/22795
description: >
Add `autoDestroy` option to automatically `destroy()` the stream
when it emits `'end'` or errors
description: Add `autoDestroy` option to automatically `destroy()` the
stream when it emits `'end'` or errors.
-->

* `options` {Object}
Expand Down Expand Up @@ -1848,7 +1845,7 @@ added: v0.9.4
changes:
- version: v10.0.0
pr-url: https://github.com/nodejs/node/pull/17979
description: call `_read()` only once per microtick
description: Call `_read()` only once per microtick.
-->

* `size` {number} Number of bytes to read asynchronously
Expand Down

0 comments on commit f58b530

Please sign in to comment.