references #7, update docs, set clean to true by default
merge