added documentation patch from Samantha. First draft needs to