Add missing module comments

src/app.rs

@@ -1,3 +1,9 @@
+//! Application builder configuring routes and middleware.
+//!
+//! `WireframeApp` stores registered routes, services, and middleware
+//! for a [`WireframeServer`]. Methods return [`Result<Self>`] so callers
+//! can chain registrations ergonomically.
+
 use std::{boxed::Box, collections::HashMap, future::Future, pin::Pin};
 
 /// Configures routing and middleware for a `WireframeServer`.

src/extractor.rs

@@ -1,3 +1,9 @@
+//! Request context types and extractor traits.
+//!
+//! The `MessageRequest` struct carries connection metadata and shared
+//! application state. Implement [`FromMessageRequest`] to extract data
+//! for handlers.
+
 use std::{net::SocketAddr, sync::Arc};
 
 /// Request context passed to extractors.

src/frame.rs

@@ -1,3 +1,9 @@
+//! Frame encoding and decoding traits.
+//!
+//! A `FrameProcessor` converts raw bytes into logical frames and back.
+//! Implementations may use any framing strategy suitable for the
+//! underlying transport.
+
 use async_trait::async_trait;
 use bytes::BytesMut;
 

src/lib.rs

@@ -1,3 +1,9 @@
+#![doc(html_root_url = "https://docs.rs/wireframe/latest")]
+//! Public API for the `wireframe` library.
+//!
+//! This crate provides building blocks for asynchronous binary protocol
+//! servers, including routing, middleware, and connection utilities.
+
 pub mod app;
 pub mod extractor;
 pub mod frame;

src/main.rs

@@ -1,3 +1,7 @@
+//! Minimal binary demonstrating `wireframe` usage.
+//!
+//! Currently prints a greeting and exits.
+
 fn main() {
     println!("Hello from Wireframe!");
 }

src/message.rs

@@ -1,3 +1,8 @@
+//! Message trait and serialization helpers.
+//!
+//! Types implementing [`Message`] can be encoded and decoded using
+//! `bincode` with standard configuration.
+
 use bincode::{
     BorrowDecode,
     Encode,

src/middleware.rs

@@ -1,3 +1,8 @@
+//! Traits and helpers for request middleware.
+//!
+//! Middleware components implement [`Transform`] to wrap services and
+//! process `ServiceRequest` instances before passing them along the chain.
+
 use async_trait::async_trait;
 
 /// Incoming request wrapper passed through middleware.

src/preamble.rs

@@ -1,3 +1,8 @@
+//! Connection preamble decoding utilities.
+//!
+//! The optional preamble is read before processing a connection, and this
+//! module provides helpers to decode it using `bincode`.
+
 use bincode::{BorrowDecode, borrow_decode_from_slice, config, error::DecodeError};
 use tokio::io::{self, AsyncRead, AsyncReadExt};
 

src/rewind_stream.rs

@@ -1,3 +1,8 @@
+//! Async stream adapter that replays leftover bytes.
+//!
+//! `RewindStream` emits any bytes buffered from a preamble read before
+//! delegating reads and writes to the underlying stream.
+
 use std::{
     io,
     pin::Pin,

src/server.rs

@@ -1,3 +1,9 @@
+//! Tokio-based server for `WireframeApp` instances.
+//!
+//! `WireframeServer` spawns worker tasks to accept TCP connections,
+//! optionally decoding a connection preamble before handing the
+//! stream to the application.
+
 use std::io;
 
 #[cfg(not(debug_assertions))]

tests/preamble.rs

@@ -1,3 +1,5 @@
+//! Tests for connection preamble reading.
+
 use bincode::error::DecodeError;
 use tokio::{
     io::{AsyncWriteExt, duplex},

tests/server.rs

@@ -1,3 +1,5 @@
+//! Tests for [`WireframeServer`] configuration.
+
 use wireframe::{app::WireframeApp, server::WireframeServer};
 
 #[test]