Skip to content

Commit dabcd47

Browse files
committed
doc: wrap style guide at 80 characters
PR-URL: nodejs#21361 Reviewed-By: Richard Lau <riclau@uk.ibm.com> Reviewed-By: Refael Ackermann <refack@gmail.com> Reviewed-By: Jon Moss <me@jonathanmoss.me> Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com> Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
1 parent dc10ddf commit dabcd47

File tree

1 file changed

+6
-2
lines changed

1 file changed

+6
-2
lines changed

doc/STYLE_GUIDE.md

+6-2
Original file line numberDiff line numberDiff line change
@@ -58,15 +58,19 @@
5858
* Use a capital letter after the "Note:" label.
5959
* Preferably, make the note a new paragraph for better visual distinction.
6060
* Function arguments or object properties should use the following format:
61-
* <code>* \`name\` {type|type2} Optional description. \*\*Default:\*\* \`defaultValue\`.</code>
62-
* E.g. <code>* `byteOffset` {integer} Index of first byte to expose. **Default:** `0`.</code>
61+
* ``` * `name` {type|type2} Optional description. **Default:** `value`. ```
62+
<!--lint disable maximum-line-length remark-lint-->
63+
* For example: <code>* `byteOffset` {integer} Index of first byte to expose. **Default:** `0`.</code>
64+
<!--lint enable maximum-line-length remark-lint-->
6365
* The `type` should refer to a Node.js type or a [JavaScript type][].
6466
* Function returns should use the following format:
6567
* <code>* Returns: {type|type2} Optional description.</code>
6668
* E.g. <code>* Returns: {AsyncHook} A reference to `asyncHook`.</code>
6769
* Use official styling for capitalization in products and projects.
6870
* OK: JavaScript, Google's V8
71+
<!--lint disable prohibited-strings remark-lint-->
6972
* NOT OK: Javascript, Google's v8
73+
<!-- lint enable prohibited-strings remark-lint-->
7074

7175
See also API documentation structure overview in [doctools README][].
7276

0 commit comments

Comments
 (0)