From 553fe281fca7a2da6991bcb396ebd9c4aec57a13 Mon Sep 17 00:00:00 2001
From: Sven-Hendrik Haase <svenstaro@gmail.com>
Date: Mon, 5 Aug 2019 18:32:00 +0200
Subject: [PATCH] Document actix-web-codegen

This fixes #105
---
 content/docs/getting-started.md      | 19 +++++++++++++++++++
 examples/getting-started/src/main.rs |  9 +++++++++
 2 files changed, 28 insertions(+)

diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md
index 21a6c44..ba06e7e 100644
--- a/content/docs/getting-started.md
+++ b/content/docs/getting-started.md
@@ -43,6 +43,24 @@ accepts a function that should return an application factory.
 That's it! Now, compile and run the program with `cargo run`.
 Head over to ``http://localhost:8088/`` to see the results.
 
+### Alternative syntax
+
+You might prefer the alternative syntax provided by [actix-web-codegen] which
+allows you to specify the routes above your functions like so:
+
+{{< include-example example="getting-started" section="alternative">}}
+
+You can then declare this function using `service()`:
+
+```rust
+App::new()
+    .service(index3)
+```
+
+For consistency reasons, this documentation only uses the regular syntax shown at the
+beginning of this page. However, if you prefer this syntax you should feel free to
+use it any time you declare a route as it's only syntactic sugar.
+
 ### Auto-reloading
 
 If you want, you can have an automatically reloading server during development
@@ -50,4 +68,5 @@ that recompiles on demand. This isn't necessary, but it makes rapid prototyping
 more convenient as you can see changes instantly upon saving.
 To see how this can be accomplished, have a look at the [autoreload pattern][autoload].
 
+[actix-web-codegen]: https://docs.rs/actix-web-codegen/0.1.2/actix_web_codegen/
 [autoload]: ../autoreload/
diff --git a/examples/getting-started/src/main.rs b/examples/getting-started/src/main.rs
index 4b2cfa6..28fd7c2 100644
--- a/examples/getting-started/src/main.rs
+++ b/examples/getting-started/src/main.rs
@@ -10,6 +10,15 @@ fn index2() -> impl Responder {
 }
 // </setup>
 
+// <alternative>
+use actix_web::get;
+
+#[get("/alternative")]
+fn index3() -> impl Responder {
+    HttpResponse::Ok().body("Sweet syntax!")
+}
+// </alternative>
+
 // <main>
 fn main() {
     HttpServer::new(|| {