move spec into readme, turn into markdown formatt