[2/2] better docs

Depends on: #51, #52.

Fixes: #25.