Open utterances-bot opened 1 week ago
Achei bem interessante o projeto e como ele simplifica a criação e depois a emissão em outro formato, porém não ficou claro pra mim como isso é consumido? Com swagger era feito o setup e depois anotados os endpoints pra criar a doc, mas com typespec como isso funciona? A especificvação acompanha a evolução da aplicação?
@adnux na minha opinião a ideia é usar o TypeSpec na fase de especificação e design da API, como ferramenta para facilitar a discussão e definição. Com essa etapa finalizada (a cada nova feature por exemplo) pode-se usar uma pipeline de CI/CD para gerar os artefatos em OpenAPI, Protobuf ou outro formato desejado.
Quanto a
A especificvação acompanha a evolução da aplicação?
Eu vejo que sim. O time deveria atualizar o TypeSpec sempre que uma nova feature ou mudança é feita na aplicação
Introdução ao TypeSpec
Vou começar esse post com um pouco de história. Lá pelo começo da década de 2010, o hype do momento era o conceito de APIs e API-first.
https://eltonminetto.dev/post/2024-10-12-intro-to-typespec/