cleaning up interfaces to hopefully be final
more changes to the interface, and updating the readme
Merge pull request #3 from diogo149/master

cleaning up interfaces to hopefully be final