forked from github/codeql
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathUndocumentedParameter.qhelp
More file actions
37 lines (27 loc) · 848 Bytes
/
Copy pathUndocumentedParameter.qhelp
File metadata and controls
37 lines (27 loc) · 848 Bytes
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
<!DOCTYPE qhelp PUBLIC
"-//Semmle//qhelp//EN"
"qhelp.dtd">
<qhelp>
<overview>
<p>
JSDoc comments for functions and constructors should use the <code>@param</code> tag to describe all available
parameters. If documentation for some parameters is missing, this may indicate badly maintained code.
</p>
</overview>
<recommendation>
<p>
The missing <code>@param</code> tags should be added.
</p>
</recommendation>
<example>
<p>
In the following example, the constructor <code>Message</code> has a JSDoc comment with a
<code>@param</code> tag documenting its first parameter <code>title</code>, but no tag for its second
parameter <code>body</code>.
</p>
<sample src="examples/UndocumentedParameter.js" />
</example>
<references>
<li>Use JSDoc: <a href="http://usejsdoc.org/tags-param.html">The @param tag</a>.</li>
</references>
</qhelp>