diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..39a8c5ff3d4961deb5a4113c362db9982de10ea7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+This is an attempt to re-structure the ai/noblogs-wp> repository using Composer.
+
+Some rough ideas on how the situation could be improved:
+
+- the ```upstream``` branch should disappear. We should not have to care ourselves on keeping a sync of Wordpress source code
+- we should really just keep the patches and our contributions
+- we need to be able to build a docker container in the end