refactored markdown parsing, added some documentation

stdsrv/src/responder.rs

@@ -1,55 +1,12 @@
-//! Traits helping HTTP connections
+//! Helper trait(s).
 
 use crate::request::HttpRequest;
 use crate::response::HttpResponse;
 
-/// Responder trait. Just a respond method that turns a HttpRequest to a HttpResponse.
+/// Responder trait. Just a respond method that turns a [`HttpRequest`] to a [`HttpResponse`].
+///
+/// [`HttpRequest`]: ../request/struct.HttpRequest.html
+/// [`HttpResponse`]: ../response/struct.HttpResponse.html
 pub trait Responder {
     fn respond(&self, req: HttpRequest) -> HttpResponse;
 }
-
-/*
-/// Size trait. Number of bytes when encoded.
-pub trait Size {
-    fn size(&self) -> usize;
-}
-
-// Standard implementations for Size trait
-
-impl Size for u8 {
-    fn size(&self) -> usize {
-        1
-    }
-}
-
-impl<T> Size for Vec<T>
-where
-    T: Size,
-{
-    fn size(&self) -> usize {
-        if let Some(elem) = self.first() {
-            elem.size() * self.len()
-        } else {
-            0
-        }
-    }
-}
-
-impl<T> Size for Option<T>
-where
-    T: Size,
-{
-    fn size(&self) -> usize {
-        match self {
-            Some(t) => t.size(),
-            None => 0,
-        }
-    }
-}
-
-impl Size for String {
-    fn size(&self) -> usize {
-        self.len()
-    }
-}
-*/