added documentation, see #8