Vylepšení dokumentace REST API

Poslední dobou jsem pracoval na integraci několika cizích API a uvědomil jsem si, že původní dokumentace je sice akademicky správná (popis sémantiky v ALPS), ale při integraci uživateli moc nepomůže.

Původně jsem chtěl dokumentaci přesunout na ReadTheDocs, ale nakonec jsem narazil na Slate. Umožňuje snadno vytvořit a spravovat přehlednou dokumentaci. Pro mě bylo výhodou i použití Middlemana, na kterém "běží" i tento web.

Zdrojové kódy pro API najdete na Bitbucket. Jak se Vám líbí nová dokumentace? S názory na novou i starou dokumentaci k API se podělte v komentářích!

Update: v prosinci 2016 byla dokumentace přesunuta na apiary.