doco (issue #7)