(#1251) - put sugar

Hey @calvinmetcalf, I just tweaked some of the docs, removed the `rev` variable because it wasn't being used, and added a test to make sure you can put a new doc with only an id (no rev).  If you're cool with the changes then go ahead and merge, looks good.