diff --git a/README b/README.md
similarity index 73%
rename from README
rename to README.md
index cc829ea..6731a67 100644
--- a/README
+++ b/README.md
@@ -1,10 +1,14 @@
+# service (BETA)
 service will install / un-install, start / stop, and run a program as a service (daemon).
 Currently supports Windows XP+, Linux/(systemd | Upstart | SysV), and OSX/Launchd.
 
-To start out follow "example/main.go".
-
-This package is still in BETA.
+Windows controls services by setting up callbacks that is non-trivial. This
+is very different then other systems. This package provides the same API
+despite the substantial differences.
+It also can be used to detect how a program is called, from an interactive
+terminal or from a service manager.
 
+## TODO
 Need to test the Interactive test for the following platforms:
  * SysV
  * systemd system and user service