updated documentation
requested changes