1.1.1 release: improve documentation and error messages