added examples to read me and small descriptions of methods in interface