timob-12125: update docs!