better documentation (see Issue #59)