diff --git a/README.md b/README.md
index 32c9d39..df3677b 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,7 @@
-# htmlon
-HTMLon is a JavaScript-powered and highly customisable rich text editor that attaches itself seamlessly to a textarea element.
+# HTMLON
+
+HTMLON (pronounced HT-em-elon, like the, er, fruit) is a JavaScript-powered rich text editor in the vein of (but much simpler and smaller than) Tiny MCE. It doesn't really need to exist; yet it does, so here we are.
+
+**HTMLON is based on `execCommand()`, which is deprecated. This project is therefore no longer maintained.**
+
+For all usage and examples see https://mitya.uk/projects/htmlon#examples