reviewed documentation, updated, closes #36