diff --git a/README.md b/README.md
index 5d2c30d..0ebe6da 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,22 @@
 # clembs.com
 
-built with [Astro](https://astro.build) and [Sass](sass-lang.com).
+tech stack:
+
+- site generation: [Astro](https://astro.build)
+- styling: [Sass](sass-lang.com)
+- packaging: [Docker](https://www.docker.com)
+- writing: [MDX](https://docs.astro.build/en/guides/integrations-guide/mdx)
+
+special thanks from:
+
+- [Clover](https://paperclover.net)
+- [Gérald](https://www.grld.dev)
+- every contributor to [mdn web docs](https://developer.mozilla.org/en-US)
+
+how to run:
+
+- you dont for now because it relies on a private repository specified in the [Dockerfile](./Dockerfile)
+
+why/how/what:
+
+- blog post coming some day