Random fixes

Feel free to mix and match
`replace` is also used with `datetime` objects. I tink `with()` would be a perfect candidate but we can't use it.  Your two proposals look a bit unwieldy to me tbh. Maybe `using()` or `replacing()`?
+1 for proper docs