Tables in the user guide
At least one table in the user guide is broken due to incorrect specification in markdown. Alongside, we might want to add some fresh things to the guide.
It would be important to also account for the list of contents (already implemented in #154 (closed) branch) - and extend it (at least in some cases) to subsections.