Reorganize code, Add comments

Author: kronolynx

src/lib.rs

@@ -4,7 +4,7 @@
 #![deny(non_snake_case)]
 #![deny(unused_mut)]
 
-//! Lightning Payments Implementation
+//! # Lightning Payments Implementation
 //!
 //! This is an implementation of
 //! [Lightning BOLT11 Specification](https://github.com/lightningnetwork/lightning-rfc/blob/master/11-payment-encoding.md)

src/macros.rs

@@ -1,4 +1,3 @@
-#[macro_export]
 /// Creates a HashMap containing the arguments
 ///
 /// - Create a HashMap containing a given list of elements:
@@ -16,7 +15,14 @@ macro_rules! hashmap {
     }}
 }
 
-/// verify that an expression matches a patter
+/// Verify that an expression matches a pattern
+///
+/// ```
+/// let a = Some(42);
+/// let b = Some(42);
+///
+/// assert!(matches!(a, b);
+///
 macro_rules! matches {
     ($e:expr, $p:pat) => (
         match $e {