- updated documentation, based on review comments