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).
Not sure, but I didn't see it in the example below, neither in the tests: is it needed?