diff --git a/helloworld/README.md b/helloworld/README.md
index 1ca26af..2615e6f 100644
--- a/helloworld/README.md
+++ b/helloworld/README.md
@@ -1,20 +1,5 @@
+A simple hello world service
+
 # Helloworld Service
 
-This is the Helloworld service
-
-## Overview
-
-An example of how to write a simple helloworld service. This can also be generated using `micro new helloworld`.
-
-## Usage
-
-```
-# run the server
-micro server
-
-# run the service
-micro run github.com/micro/services/helloworld
-
-## call the service
-micro call helloworld Helloworld.Call '{"name": "Alice"}'
-```
+Helloworld simply returns a personalized message in response to a name.