improved linter based on comments
improved readme based on comments