change some language from mailing-list post to doc
various language improvements