docs update, closes #242