diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..33f4306
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,15 @@
+# Hello worlding
+
+A collection of writing machines to explore practices of code documentation.
+
+A set of tools and prompts to handle code documentation. To reflect and operate on the words they use, on the assumption they make, on the ways they are produced.
+
+A writing machine is a device that transforms writing. It can be a tool, such as a pen or a typewriter or a text editor, it can be a practical approach, like documenting in pairs or avoiding or insisting on specific terms.
+
+This collection includes strategies developed during the past two years of within the context and infrastructure of the Soupboat.
+
+_Uhm ,,, "Collection" is a bit of a static term, i would prefer something more inflatable._
+
+
+
+- organize a space for the writing machines