io, serde, schema: doc fixups

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

proxmox-io/src/std_channel_writer.rs

@@ -4,7 +4,8 @@ use std::sync::mpsc::SyncSender;
 
 /// Wrapper around SyncSender, which implements Write
 ///
-/// Each write in translated into a send(Vec<u8>).
+/// Each write in translated into a `send(Vec<u8>)` (that is, for each write, an owned byte vector
+/// is allocated and sent over the channel).
 pub struct StdChannelWriter<E>(SyncSender<Result<Vec<u8>, E>>);
 
 impl<E: ToString> StdChannelWriter<E> {

proxmox-schema/src/de/verify.rs

@@ -99,7 +99,7 @@ fn push_err_do(path: String, err: anyhow::Error) {
 
 /// Helper to collect multiple deserialization errors for better reporting.
 ///
-/// This is similar to [`IgnoredAny`] in that it implements [`Deserialize`]
+/// This is similar to [`IgnoredAny`](serde::de::IgnoredAny) in that it implements [`Deserialize`]
 /// but does not actually deserialize to anything, however, when a deserialization error occurs,
 /// it'll try to continue and collect further errors.
 ///

proxmox-serde/src/lib.rs

@@ -180,7 +180,7 @@ pub mod string_as_base64 {
     }
 }
 
-/// Serialize Vec<u8> as base64url encoded string without padding.
+/// Serialize `Vec<u8>` as base64url encoded string without padding.
 ///
 /// Usage example:
 /// ```