doc: more precisions on RTIO error handling
pdq2: small improvements based on ML feedback