Fix bugs and improve the existing parsing API

This adds basic `example` parsing, improves the tests and fixes bugs
with `comment-parser` module.