
Por que documentar antes?
Ao criarmos um sistema é bem comum também criarmos uma documentação junto com este sistema. Se pensarmos na documentação dos endpoints usando, por exemplo, um Swagger podemos utilizar uma das diversas ferramentas que geram essa documentação para nós, porém não devemos utiliza-las!! Neste artigo vou falar mais um pouco sobre isso, explicar qual a motivação de não usa-las e dar alguns exemplos do que passei na minha carreira.