better sample file commented instructions
fixes #4 -- use git path instead of url
refs #8; fixes #3 #7 -- project file methods to service object and usable through UI