more error info + readme; 100% coverage