494 fix doc to be friendly for this lady to read

Ticket #494