Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Commit 4566eba

Browse filesBrowse files
Trotttargos
authored andcommitted
doc: wrap style guide at 80 characters
PR-URL: #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 6c41f33 commit 4566eba
Copy full SHA for 4566eba

File tree

Expand file treeCollapse file tree

1 file changed

+6
-2
lines changed
Open diff view settings
Filter options
Expand file treeCollapse file tree

1 file changed

+6
-2
lines changed
Open diff view settings
Collapse file

‎doc/STYLE_GUIDE.md‎

Copy file name to clipboardExpand all lines: doc/STYLE_GUIDE.md
+6-2Lines changed: 6 additions & 2 deletions
  • Display the source diff
  • Display the rich diff
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 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.