added documentation from e-mail