interfaces, minor fixes and initial Readme.md