diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2c648c9
--- /dev/null
+++ b/README.md
@@ -0,0 +1,13 @@
+Dieses Projekt enthält die Schnittstellendefinition, 
+einen Demoserver und verschiedene Clientimplementierungen für Produktwissen.
+
+Die Schnittstelle soll mit Smart-Clients interagieren können.
+Dazu wird das Hydra-Vocabulary eingesetzt.
+
+ * https://www.hydra-cg.com/spec/latest/core/
+ * https://www.markus-lanthaler.com/research/third-generation-web-apis-bridging-the-gap-between-rest-and-linked-data.pdf
+
+Integration in die Anwendung (Jakarta EE / Spring)
+ direkt in deine Spring Boot Anwendung einbetten, damit sie unter http://localhost:8080/docs/index.html erreichbar ist:
+
+Konfiguriere das Maven-Plugin so, dass es die Antora-Ausgabe nach server-app/src/main/resources/static/docs kopiert.
diff --git a/docs/README.md b/docs/README.md
deleted file mode 100644
index 48b1eb6..0000000
--- a/docs/README.md
+++ /dev/null
@@ -1,4 +0,0 @@
-Integration in die Anwendung (Jakarta EE / Spring)
- direkt in deine Spring Boot Anwendung einbetten, damit sie unter http://localhost:8080/docs/index.html erreichbar ist:
-
-Konfiguriere das Maven-Plugin so, dass es die Antora-Ausgabe nach server-app/src/main/resources/static/docs kopiert.