fixed documentation, closes #27