finish framing_sv2 docs

protocols/v2/framing-sv2/src/framing2.rs

@@ -90,12 +90,14 @@ impl<T, B> Default for Sv2Frame<T, B> {
 }
 
 /// Abstraction for a Noise Frame
+/// In practice, it is only used as the alias `HandShakeFrame`
+/// Contains only a `Slice` payload
 #[derive(Debug)]
 pub struct NoiseFrame {
     payload: Slice,
 }
 
-/// todo
+/// The only practical usage of `NoiseFrame`
 pub type HandShakeFrame = NoiseFrame;
 
 impl NoiseFrame {
@@ -340,7 +342,8 @@ fn update_extension_type(extension_type: u16, channel_msg: bool) -> u16 {
     }
 }
 
-/// todo
+/// A wrapper to be used in a context we need a generic reference to a frame
+/// but it doesn't matter which kind of frame it is (`Sv2Frame` or `HandShakeFrame`)
 #[derive(Debug)]
 pub enum EitherFrame<T, B> {
     HandShake(HandShakeFrame),

protocols/v2/framing-sv2/src/lib.rs

@@ -3,7 +3,7 @@
 //!
 //! This crate provides primitives for framing of SV2 binary messages.
 //!
-//! The message framing is outlined below:
+//! The message framing is outlined below ([according to SV2 specs](https://stratumprotocol.org/specification/03-Protocol-Overview/#32-framing)):
 //!
 //! | Protocol Type  | Byte Length | Description |
 //! |----------------|-------------|-------------|