improve docs. ref #10