Přesun dokumentace na Apiary a Bitbucket
Před 2 roky jsem přepsal API dokumentaci do Slate. Od té doby Apiary rapidně zlepšilo možnosti dokumentace (popis json objektů, použití dokumentace), takže ode dneška najdete API dokumentaci na https://rozpisyzapasu.docs.apiary.io/.
Důvody přesunu
- méně kódu - místo repozítáře s dokumentací teď udržuji jeden markdown soubor
- přehlednější dokumentace - integrace cizího API s Apiary mě baví, doporučuji zkusit konzoli
Doladění API dokumentace
Víceméně jsem přepsal původní dokumentaci do API blueprintu. Teď budu dolaďovat texty a příklady. Pokud narazíte na chyby/nesrozumitelnosti v dokumentaci, tak se ozvěte v komentářích! Předem díky.
Přesun ukázek integrace API
Zároveň jsem z webu přesunul dokumentaci integrací na Bitbucket. Stávající integrace jsou z diplomky z roku 2014. Do budoucna už je neplánuji nijak udržovat.