Add spec to README
Add comments and update i/o