better doc string for Either

guide/src/qs_4.md

@@ -253,7 +253,7 @@ use actix_web::{Either, Error, HttpResponse, httpcodes};
 type RegisterResult = Either<HttpResponse, Box<Future<Item=HttpResponse, Error=Error>>>;
 
 fn index(req: HttpRequest) -> RegisterResult {
-    if true {          // <- choose variant A
+    if is_a_variant() { // <- choose variant A
         Either::A(
             httpcodes::HttpBadRequest.with_body("Bad data"))
     } else {
@@ -264,12 +264,12 @@ fn index(req: HttpRequest) -> RegisterResult {
                    .map_err(|e| e.into())).responder())
     }
 }
-
+# fn is_a_variant() -> bool { true }
-fn main() {
+# fn main() {
-    Application::new()
+#    Application::new()
-        .resource("/register", |r| r.f(index))
+#        .resource("/register", |r| r.f(index))
-        .finish();
+#        .finish();
-}
+# }
 ```
 
 ## Tokio core handle

src/handler.rs

@@ -46,8 +46,9 @@ pub trait Responder {
 ///
 /// type RegisterResult = Either<HttpResponse, Box<Future<Item=HttpResponse, Error=Error>>>;
 ///
+///
 /// fn index(req: HttpRequest) -> RegisterResult {
-///     if true {          // <- choose variant A
+///     if is_a_variant() { // <- choose variant A
 ///         Either::A(
 ///             httpcodes::HttpBadRequest.with_body("Bad data"))
 ///     } else {
@@ -58,6 +59,7 @@ pub trait Responder {
 ///                    .map_err(|e| e.into())).responder())
 ///     }
 /// }
+/// # fn is_a_variant() -> bool { true }
 /// # fn main() {}
 /// ```
 #[derive(Debug)]