added documentation
after review