f new doc

Author: TheBlueMatt

lightning/src/util/ser_macros.rs

@@ -1065,9 +1065,9 @@ macro_rules! impl_writeable_tlv_based_enum {
 /// when [`MaybeReadable`] is practical instead of just [`Readable`] as it provides an upgrade path for
 /// new variants to be added which are simply ignored by existing clients.
 ///
-/// Note that variants written as `$tuple_variant`s will not support downgrading no matter the
-/// `$tuple_variant_id` used, however any variants written as a normal variant will support
-/// downgrading by having [`MaybeReadable`] return `None` for variants not understood.
+/// Note that variants written as tuple variants will not support downgrading no matter the
+/// `$tuple_variant_id` used. Any variants written as a normal variant will support downgrading by
+/// having [`MaybeReadable`] return `None` for odd `$variant_id` variants not understood.
 ///
 /// [`MaybeReadable`]: crate::util::ser::MaybeReadable
 /// [`Writeable`]: crate::util::ser::Writeable