diff --git a/README.md b/README.md
index e69de29..469c458 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,17 @@
+# jing-go
+first steps in golang, implemented a little ping tool with something missing most ping implementations:
+- json output
+- target list
+
+# usage
+
+jing one host
+./jing -t 127.0.0.1
+
+jing a list of hosts
+./jing -T targets.txt
+
+jing a list of hosts with json output
+./jing -T targets.txt -J
+
+# happy jing