Hello,

I'm in the process of documenting my code. Here are a few questions I have. Tell me if I'm doing it right or wrong:

1.
A param can be either a string, an integer or a boolean:
@param{(String|Integer|Boolean)} myParam

2.
A method returns "this" (the "MyObject" itself)
@return {MyObject.Instance}

3.
A boolean param is optional
@param {Boolean} (optional)

4.
A param is either the window object, window.document or an HTMLDocument
@param {Object|HTMLElement} myParam

5.
A param is a function
@param {Function} myParam

6.
If a param is optional, how to specifiy its default value?
@param {Boolean} (optional) Default is true

7. If I make a reference to another method of an object, how to do it properly?
@see otherMethod
(should there be brackets? Should the method be prefixed by the Object name?)

8. If an integer is returned, should I rather say it's a number?
@return {Number}
vs.
@return {Integer}

All the best.

-jj.