several improvements in documentation
minor change description