README generator and docs improved