documentation, closes #1