Assumir @type function como padrão

[izacsc]

Caso não tenha sido definido, assumir @type function, por ser a maioria nos fontes.
Com isso diminui significantemente a quantidade de warnings emitidos.

[AlencarGabriel]

Olá @izacsc , muito interessante tua solicitação.

Estarei verificando e implementando já para próxima versão.

[AlencarGabriel]

Olá @izacsc ,

estive analisando essa issue pra lançar já na proxima versão, e percebi que a extensão não deixa o atributo @type com "valor default". Ele detecta a assinatura da função, método ou classe e aplica o atributo conforme o tipo.

Portanto não faria sentido deixar function como default, se a geração da documentação já é dinâmica.

Poderia esclarecer melhor sua sugestão?

[izacsc]

Bom dia! A sugestão é para a avaliação e não para a criação de novas documentações. Quando vc já tem uma documentação que não tem o atributo @type, assumir que a documentação se refere à uma function. Em ter, 16 de mar de 2021 10:52, Gabriel Alencar ***@***.***> escreveu:

…

Olá @izacsc <https://github.com/izacsc> , estive analisando essa issue pra lançar já na proxima versão, e percebi que a extensão não deixa o atributo ***@***.*** <https://github.com/type>* com "valor default". Ele detecta a assinatura da função, método ou classe e aplica o atributo conforme o tipo. Portanto não faria sentido deixar *function* como default, se a geração da documentação já é dinâmica. Poderia esclarecer melhor sua sugestão? — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#55 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AADHMGJXSJWXLPXP6GCCY5TTD5PCPANCNFSM4WV2IVGQ> .

[izacsc]

@AlencarGabriel ficou claro? Preciso esclarecer mais algum ponto?

[AlencarGabriel]

Ficou claro sim, agora compreendi melhor.

Porém preciso avaliar melhor, pois o atributo @type é um dos obrigatórios, e eu trato ele em diversos pontos da extensão, pra fazer isso que sugeriu eu teria que alterar em todos esses pontos pra considerá-lo como: @type function default.

[AlencarGabriel]

• Tornar todos os atributos opcionais em seu conceito (visto haver uma grande variedades de uso do ProtheusDoc);
• Criar uma configuração para definir quais atributos ProtheusDoc devem ter validação de omissão;
• ...