updated docs as per comment in Issue #34