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

screenshot from 2016-12-20 14 54 10

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.