fail by default
some clarifications
added a README