rewording and doc cleanup