updating the user documentation - more updates still required