diff --git a/README.md b/README.md
index 4b304e9..3340e4d 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,14 @@
 
 Show off your favorite public threads and offer hand-picked, fine-grained, topical subscriptions!
 
+These are streams of thought you decide to float to your personal site for being a bit more-effort than other small posts, but still yet to be refined as a blog.
+
+How it works:
+1. a featured status will be fetched on the server along with qualified "descendants", which are replies of the same author in a single thread.
+2. clean HTML with some styling will be sent to the viewer's browser
+3. it is therefore zero-JS as of yet
+4. self-hostable with the app configuration in `threads.py` file -- we are working on a docker way and easy configuration
+
 See it [in action](https://ayco.io/threads).
 
 ## Project setup