contributing and improvements

@devmanhinton edits welcome.