docs

README
also removes zsh backward incompatibility warning