Mês de férias, planejamento com antecedência, pesquisas, economias direcionadas, até que chega o momento de embarcar, mais uma vez, rumo a um destino desconhecido. Momentos marcantes, hora de registrar um pouco dessa aventura.

Tem sido assim, desde que conheci a Tati. Nossa afinidade por viagens não foi só pretexto pra nos conhecermos :) Março/2020 tem mais e já estamos na expectativa (sem spoilers do destino). Vai render outro post em breve.

Voltando ao motivo deste, a terra da bota, assim foi o nosso roteiro:

11/03/2019 — Roma
13/03/2019 — Florença
15/03/2019 — Pisa
15/03/2019 — Gênova
17/03/2019 — Milão
20/03/2019 — Veneza
24/03/2019 — Roma

Com o tempo, e se a memória ajudar, vou atualizando com mais informações.


Documenting APIs could be a pain task, if you are not using a framework to do it. The chances to leaving docs out of date are elevated. To avoid this scenario, there are some alternatives, like Swagger and, the purpose of this post, Spring REST Docs.

I’m using Swagger in some projects and I like it, given the facility to use. For who doesn’t know, how to document APIs using Swagger, here is the steps. You will need to include a dependency in your Project and so configure your Application class to enable Swagger. Given this configuration, just include some…


Documentar APIs pode ser uma tarefa um tanto quanto trabalhosa, desde que não seja feita com o auxílio de alguma ferramenta/framework. As chances de uma documentação, ficar inconsistente/desatualizada, é enorme. Para evitar este cenário, existem algumas alternativas, como o Swagger e, o motivo deste post, Spring REST Docs.

Utilizo o Swagger em alguns projetos e aprecio seu uso, dado sua facilidade. Para quem não conhece, como documentar APIs usando Swagger, irei resumir. Você precisará incluir a dependência em seu Projeto e então configurar sua classe de application para habilitar o Swagger. Dada esta configuração, basta então incluir as anotações no…

Thiago Nogueira

Software Engineer

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store