README improvements (outputs, usage, errors sections)