touching up documentation

try 2