Na Qmino (a empresa que cria a Miredot), escrevemos centenas de APIs REST.Nós projetamos e reprojetamos até que nossas APIs sejam uma alegria de usar.Documentação é a interface do usuário de uma API.Isso é algo em que acreditamos firmemente.A única maneira de realmente mostrar uma boa API é fornecendo documentação bonita e correta para os desenvolvedores aproveitarem.É por isso que somos muito meticulosos em documentação.Até deixamos a falta de Javadoc falhar, nossas compilações e revisões de código incluem a verificação dos documentos.Além disso, fazemos com que o Miredot falhe na compilação se detectar algo errado com os documentos da API REST.Miredot Alguns anos atrás, realmente não conseguimos encontrar nenhuma boa ferramenta de documentação da API REST para Java.Queríamos algo que usasse artefatos existentes, como Javadoc, o código-fonte Java, anotações e assim por diante.Algo que entende as estruturas que usamos, como jax-rs, spring e jackson, e a transforma em algo bonito.Algo que os consumidores de nossas APIs adoram usar.É exatamente isso que estamos buscando com a Miredot.E, até agora, estamos muito orgulhosos do resultado!