f - reword docs

Author: jkczyz

lightning/src/offers/offer.rs

@@ -9,8 +9,9 @@
 
 //! Data structures and encoding for `offer` messages.
 //!
-//! An [`Offer`] is built by the merchant for the user-pays-merchants flow and may be parsed from a
-//! string by the user, typically after being scanned from a QR code.
+//! An [`Offer`] represents an "offer to be paid". It is typically constructed by a merchant and
+//! published as a QR code to be scanned by a customer. The customer uses the offer to request an
+//! invoice from the merchant to be paid.
 //!
 //! ```
 //! extern crate bitcoin;
@@ -68,7 +69,7 @@ use prelude::*;
 #[cfg(feature = "std")]
 use std::time::SystemTime;
 
-/// Builds an [`Offer`] for the user-pays-merchant flow.
+/// Builds an [`Offer`] for the "offer to be paid" flow.
 ///
 /// See [module-level documentation] for usage.
 ///