Issue #595 - updated docs per feedback from the boss.