Oi Guilherme, tudo bem? Eu comento sobre isto no começo e no final. O uso de doc no meio do código pode ser prejudicial, porque acaba aumentando o número de linhas de código, dificultando a manutenção e o foco que é codificação mesmo. Além de não ter o incentivo para fazer uma documentação mais adequada. Também tem uma certa influência em como framework incentiva a documentar. A Microsoft tem uma ótima experiência com ele para gerir as API doc da Azure. Ele foi criado justamente, porque documentar no código ou documentar diretamente o OpenAPI e manter ao longo do tempo se tornou uma tarefa impraticável
Conheça nosso novo lançamento: Curso Full Cycle 4.0
fcycle.co/282-typespec
lembrei do nest js nesses negocio de usar decorator
Isso para fastfy e express vai ser incrível
no fastify eu prefiro usar plugin pra gerar a api, no express é uma mão na roda mesmo
brabo
Usar FastAPI já resolve tudo isso. Por isso amo Python.
Oi Guilherme, tudo bem?
Eu comento sobre isto no começo e no final. O uso de doc no meio do código pode ser prejudicial, porque acaba aumentando o número de linhas de código, dificultando a manutenção e o foco que é codificação mesmo. Além de não ter o incentivo para fazer uma documentação mais adequada. Também tem uma certa influência em como framework incentiva a documentar.
A Microsoft tem uma ótima experiência com ele para gerir as API doc da Azure. Ele foi criado justamente, porque documentar no código ou documentar diretamente o OpenAPI e manter ao longo do tempo se tornou uma tarefa impraticável