personal web log written by izabeera and dryobates

Documenting Flask REST API in Sphinx

Many REST frameworks have built in documentation for provided API. Many specialized software exists for centralized API documentation. But if all you need is to include documentation for your project in your regular sphinx documentation then sphinxcontrib-httpdomain can be helpful.

11 Oct 2016 by dryobates

Python3's typehints in Sphinx documenation

The most popular use for Python3's annotations are type hints. By default Sphinx can't use that type hints to document modules. Luckily for us Sphinx is easily extensible...

10 Oct 2016 by dryobates

Realtime reStructuredText preview in browser with Vim and InstantRst

Most of my projects documentation is written in reStructuredText with riv in vim. Same is for all those blog entries here. Until up recently my workflow was traditional: write, save, generate html, preview. Now it has changed...

09 Oct 2016 by dryobates

DSDM Agile PM - How good you are?

Company that I work in has chosen DSDM AgilePM as a method for our current project. I was one of *the chosens* that were sent to AgilePM training. So I have gained some knowledge that should be tested...

03 Oct 2016 by dryobates

Jakub Stolarski. Software engineer. I work professionally as programmer since 2005. Speeding up software development with Test Driven Development, task automation and optimization for performance are things that focus my mind from my early career up to now. If you ask me for my religion: Python, Vim and FreeBSD are my trinity ;) Email: