updated documentation per comments