pending spec...
module style
rewrite readme to the new api