V Qmino (podjetje, ki ustvarja Miredot) smo napisali na stotine REST API-jev.Oblikujemo in prenavljamo, dokler naši API-ji ne bodo veseli uporabe.Dokumentacija je uporabniški vmesnik API-ja.To je tisto, v kar trdno verjamemo.Edini način, kako resnično pokazati dober API, je zagotavljanje lepe in pravilne dokumentacije, s katero lahko razvijalci uživajo.Zato smo zelo natančni glede dokumentacije.Pustimo celo, da nam pomanjkanje Javadoca ne uspe, naši pregledi gradnje pa vključujejo preverjanje dokumentov.Poleg tega Miredot ne uspe sestaviti, če odkrije kaj narobe z dokumenti REST API.Miredot Pred nekaj leti res nismo mogli najti nobenega dobrega orodja za dokumentacijo REST API za Javo.Želeli smo nekaj, kar vsebuje vse obstoječe artefakte, kot so Javadoc, izvirna koda Java, pripombe in tako naprej.Nekaj, kar razume okvire, uporabimo suchas jax-rs, spring in jackson in to spremeni v nekaj lepega.Nekaj, kar potrošniki naših API-jev radi uporabljajo.Ravno to si prizadevamo z Miredotom.In do zdaj smo na rezultat zelo ponosni!