Some documentation improvements

Please proof-read this very carefully, documentation is important, and I don't
know much about daybed yet, so I could very possibly be wrong about some of
those modifications.

Also, if you have a better idea than replacing all the `v1` everywhere in the
URLs on the next version (like using a variable or something), please let me
know (i've checked ext_link and rst_epilog, but none seem to do the job... or
be usable in code blocks).
This shouldn't be the `Hawk-Session-Token` for `ad37fc395b7ba83eb496849f6db022fbb316fa11081491b5f00dfae5b0b1cd22` it should be `e0394574578356252e2033b829b90291e2ff1f33ccbcbcec777485f3a5a10bca`

If you want to try: 

    http GET http://www.perdu.com --auth-type hawk --auth ad37fc395b7ba83eb496849f6db022fbb316fa11081491b5f00dfae5b0b1cd22: -v

The id will be in the Authorization header.