diff --git a/README b/README
deleted file mode 100644
index e69de29..0000000
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..383639d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+# Test-Tap a 0 dependency single file Test Anything Protocol suite.
+
+# Install
+
+copy `src/Tap.mjs` into your source tree.
+
+Eventually I'll see about publishing it to npm but for now this is good enough.
+
+# Use
+
+See the `tests/01_tap.t.js` and `TapHarness.html` for node cli and browser based examples.