diff --git a/README.md b/README.md
index c8334d0..a2f20a1 100644
--- a/README.md
+++ b/README.md
@@ -574,7 +574,7 @@ or
     ```go
     type Service interface {
         //kun:op POST /users
-        //kun:body age name=user_age type=string descr=The-user-age
+        //kun:body age name=user_age type=string descr='The user age'
         CreateUser(ctx context.Context, name string, age int) (err error)
     }
 
diff --git a/examples/messaging/README.md b/examples/messaging/README.md
index 8600420..a005033 100644
--- a/examples/messaging/README.md
+++ b/examples/messaging/README.md
@@ -1,6 +1,6 @@
 # messaging
 
-This example illustrates how to specify multiple HTTP operations.
+This example illustrates how to specify multiple HTTP request operations.
 
 
 ## Generate the code