From cc20ca9fc9d594c464b1c0202ffba7638fe27c12 Mon Sep 17 00:00:00 2001
From: Thane Thomson <connect@thanethomson.com>
Date: Fri, 21 Oct 2022 13:16:48 -0400
Subject: [PATCH] docs: Apply suggestions from #1212 code review

Signed-off-by: Thane Thomson <connect@thanethomson.com>
---
 proto/src/serializers/bytes.rs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/proto/src/serializers/bytes.rs b/proto/src/serializers/bytes.rs
index d5aa786d9..ecd41c6be 100644
--- a/proto/src/serializers/bytes.rs
+++ b/proto/src/serializers/bytes.rs
@@ -7,7 +7,7 @@ pub mod hexstring {
 
     use crate::prelude::*;
 
-    /// Deserialize hexstring into `Vec<u8>`
+    /// Deserialize a hex-encoded string into `Vec<u8>`
     pub fn deserialize<'de, D>(deserializer: D) -> Result<Vec<u8>, D::Error>
     where
         D: Deserializer<'de>,
@@ -18,7 +18,7 @@ pub mod hexstring {
             .map_err(serde::de::Error::custom)
     }
 
-    /// Serialize from `T` into hexstring
+    /// Serialize from a byte slice into a hex-encoded string.
     pub fn serialize<S, T>(value: &T, serializer: S) -> Result<S::Ok, S::Error>
     where
         S: Serializer,
@@ -68,7 +68,7 @@ pub mod base64string {
     }
 }
 
-/// Serialize into `Vec<base64string>`, deserialize from `Vec<base64string>`
+/// Serialize into and deserialize from a sequence of _base64string_.
 pub mod vec_base64string {
     use serde::{Deserialize, Deserializer, Serializer};
     use subtle_encoding::base64;
@@ -103,7 +103,7 @@ pub mod vec_base64string {
     }
 }
 
-/// Serialize into `Option<base64string>`, deserialize from `Option<base64string>`
+/// Serialize into and deserialize from an optional _base64string_.
 pub mod option_base64string {
     use serde::{Deserialize, Deserializer, Serializer};
     use subtle_encoding::base64;