0
В Qmino (компанията, която създава Miredot), сме написали стотици REST API.Ние проектираме и преработваме, докато нашите API не се радват за използване.Документацията е потребителският интерфейс на API.В това твърдо вярваме.Единственият начин наистина да покажете добър API е да предоставите красива и коректна документация, за да могат потребителите да се наслаждават.Ето защо ние сме много внимателни по отношение на документацията.Дори позволяваме на липсата на Javadoc да се провали, а нашите прегледи на кодове включват проверка на документите.След това правим Miredot да провали сборката, ако открие нещо нередно с документите REST API.Miredot Преди няколко години ние наистина не можахме да намерим добър Java REST API документация инструмент за Java.Искахме нещо, което отнема всички съществуващи артефакти като Javadoc, изходния код на Java, пояснения и т.н.Нещо, което разбира рамките, ние използваме suchas jax-rs, spring и jackson и го превръщаме в нещо красиво.Нещо, което потребителите на нашите API-та обичат да използват.Точно към това непрекъснато се стремим с Miredot.И досега сме много горди с резултата!