jsguide: Unclear rule - Indented four spaces for Line-wrapped block tags #594
Description
https://google.github.io/styleguide/jsguide.html#jsdoc-line-wrapping
Line-wrapped block tags are indented four spaces. Wrapped description text may be lined up with the description on previous lines, but this horizontal alignment is discouraged.
-
Both below have same issues - when extra comments are edited:
- Line-wrapped block tags are indented four spaces.
- Wrapped description text may be lined up with the description on previous lines, but this horizontal alignment is discouraged.
-
Also, why not have them on with new blank lines, when long description?
-
Or, why not do similar to @fileoverview - "Wrapped lines are not indented."?