Docs build wrongly reports errors

[josephjclark]

If you have a typedef before a signature:

/**
 * Options provided to the Asana API request
 * @typedef {Object} RequestOptions
 * ...
 */

/**
 * Make a HTTP request against the Asana API.
 * @public
 * ...
 */
export function request(path, params = {}, callback) {

The docs build will report an error:

Warning: Multiple leading comment blocks found. Discarding all but first:
...
Warning: Invalid documentation for request ✗ Stated params are '', but detected params are '["path","params","callback"]'.

Basically it ignores the ACTUAL type def.

This is totally bogus, the generated docs are fine.

A quick fix might be to use the LAST comment block, not the first?