write some specs and update the README