diff --git a/README.md b/README.md
index a8c0deb..f747442 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,13 @@
 # webcomponents
 
-HTML Web Components
\ No newline at end of file
+A small set of not-super-useful [Web Components][1]
+
+* djl-lipsum  - lorem-ipsum on demand!
+* djl-script  - inline, editable javascript!
+* djl-spinner - a generic loading spinner!
+* djl-json    - display a JSON property!
+
+For examples, see [example.html](example.html).
+
+[1]: https://developer.mozilla.org/en-US/docs/Web/Web_Components
+