diff --git a/README.md b/README.md
new file mode 100644
index 0000000..cc5245d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,13 @@
+semstr - Go package for parsing and comparing [semantic version](https://semver.org) like strings
+
+Allowed format is less stringent than semantic versioning to
+accomodate more usecases.
+
+    [v]MAJOR[.MINOR[.PATCH[-PRERELEASE][+BUILD]]]
+
+
+## Quick use
+
+    go get [github.com/gregoryv/semstr](https://pkg.go.dev/github.com/gregoryv/semstr)
+
+