functions stubs .. some implementation, readme update, the boring stuff