docs: add API/ABI disclaimer.
build: add message of doom!
stream: rename written to r.

Written is confusing since it is not actually accurate here. Let's just
use r for return value of syscalls since we interprit the result
anyway.