最近、比較的真面目にJsDocを書くという機会があったので。 (※この記事の前提はJsDoc 3.2.2です) JSで適当に名前空間的なものを切ってコードを書いていくと、 /** * @class /* function Klass() { } Klass.prototype.foo = function () { }; my.name.space.Klass = Klass; みたいな書き方がいいか、 /** * @class /* my.name.space.Klass = function() { }; my.name.space.Klass.prototype.foo = function() { }; みたいな書き方がいいか、という割とどうでも良い選択(意味的には同じなので)を迫られることがありますが、これは結論的には後者の方がよくて、 後者だとJsDocが勝手にKlassがmy