issue #5: doco