added descriptive readme
fixed pylint issues except names
fixed names to match requirements