mirror of
https://github.com/airbnb/javascript.git
synced 2026-01-14 11:07:58 -05:00
[guide] remove subtle endorsement of JSDoc-style commenting.
This commit is contained in:
@@ -1749,7 +1749,7 @@ Other Style Guides
|
||||
## Comments
|
||||
|
||||
<a name="comments--multiline"></a><a name="17.1"></a>
|
||||
- [17.1](#comments--multiline) Use `/** ... */` for multi-line comments. Include a description, specify types and values for all parameters and return values.
|
||||
- [17.1](#comments--multiline) Use `/** ... */` for multi-line comments.
|
||||
|
||||
```javascript
|
||||
// bad
|
||||
@@ -1768,10 +1768,7 @@ Other Style Guides
|
||||
// good
|
||||
/**
|
||||
* make() returns a new element
|
||||
* based on the passed in tag name
|
||||
*
|
||||
* @param {String} tag
|
||||
* @return {Element} element
|
||||
* based on the passed-in tag name
|
||||
*/
|
||||
function make(tag) {
|
||||
|
||||
|
||||
Reference in New Issue
Block a user