Fix document pointer documentation

Improve clarity and remove wrong documentation about using `is_valid` to
check if a document still exists.

Deprecate `DOC_VALID` (IIRC it was needed mostly for legacy reasons).