O cursor está dentro do literal do objeto, certo? Esse é um contexto válido para comentários JSDoc em geral:
const a = {
/**
* Description
*/
b: 1
}
Esse é um contexto válido para comentários JSDoc em geral:
Por quê? Eu esperaria que jsdoc seja usado apenas em declarações de símbolo, como a declaração de Electron.SaveDialogOptions
não em todas as instanciações dele. O cursor está entre as chaves, nada é declarado lá, na verdade nada foi escrito lá, então para qual símbolo estou adicionando comentários jsdoc?
Isso não faz sentido sugerir JSDoc em todos os lugares e colocá-lo como o primeiro item simplesmente porque começa com /
.
Comentários muito úteis
Por quê? Eu esperaria que jsdoc seja usado apenas em declarações de símbolo, como a declaração de
Electron.SaveDialogOptions
não em todas as instanciações dele. O cursor está entre as chaves, nada é declarado lá, na verdade nada foi escrito lá, então para qual símbolo estou adicionando comentários jsdoc?