revised documentation to Ian and Michael's suggestions