updated documentation, closes #5