updated documentation after review