documentation, closes #2