JSDoc - правильный способ создания пользовательского типа в отдельном файле

Я хочу создать собственный тип, например, для завершения кода в отдельном файле с именем custom-types.js, как я нашел в заголовке Репозиторий Rzslider angular, в файле Файл Rzslider.js внизу:

/**
 *
 * @name Author
 * @property {number} id
 * @property {string} name
 * @property {string} surname
 */

Является ли это правильным способом документирования собственных типов? Важно, чтобы он был в отдельном файле, чтобы как можно меньше загрязнять код JSDoc комментариями. Я использую JSDoc 3 с плагином, привязанным к Intellij 14, заранее спасибо за помощь.


person Radek Anuszewski    schedule 27.07.2015    source источник
comment
О документировании угловых кодов с помощью jsdoc я ответил на аналогичный вопрос здесь.   -  person gm2008    schedule 07.06.2016
comment
@ gm2008 gm2008 Спасибо, не могли бы вы разместить свой ответ как обычный пост? Тогда я могу это принять.   -  person Radek Anuszewski    schedule 15.06.2016
comment
О документировании угловых кодов с помощью jsdoc я ответил на аналогичный вопрос. См. его здесь.   -  person gm2008    schedule 16.06.2016
comment
Это должен быть комментарий, а не ответ. Если это повторяющийся вопрос, проголосуйте за закрытие как такового и/или оставьте комментарий.   -  person Tunaki    schedule 16.06.2016