diff --git a/README.md b/README.md
index e5e137a..866f8f6 100644
--- a/README.md
+++ b/README.md
@@ -2,4 +2,16 @@
 
 ![fuoco](cover.jpg)
 
-A small framework to document project on the soupboat using a shared flat markup list as source.
+A small framework to document project on the soupboat using a shared flat markup list as source. Meant to be edited by users of the soupboat to document their things.
+
+It's a single file CMS. The syntax of this file is really minimal, and it works together with the linear nature of the list to organize the contents. There are just a couple of level of hierarchy, hence the idea of flat structure.
+
+```
+(title)
+[section]
+--> Notes
+>>comment (TBD)
+Normal text
+```
+
+Find it live on the [soupboat](https://hub.xpub.nl/soupboat/bonfire/)