perhaps
- make doc wording stronger ("impls must not..")
- remove WriteAllError, panic instead
- fix the adapters so they convert Ok(0) to an error (lol)