some messaging and documentation changes
...