diff --git a/README.md b/README.md
index 024dc05..2dd2152 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,43 @@
-# nim-lecture
+# Nim Vorlesung
 
+Willkommen zur Nim Vorlesung! Dieses Repository enthält alle wichtigen Informationen, Materialien und die dazugehörigen Übungen für die Vorlesung.
+Aus zeitlichen Gründen empfehlen wir die Verwendung eines [Online Compilers][1] für das Bearbeiten der Aufgaben.
+Die Vorlesungsfolien finden Sie [hier](./skript/folien/praesentation.pdf)
+
+## Themenüberblick
+
+| #   | Thema                                          |
+| --- | ---------------------------------------------- |
+| 1.  | [Schlüsselwörter](./skript/keywords.md)        |
+| 2.  | [Datentypen](./skript/datentypen.md)           |
+| 3.  | [Operatoren](./skript/operatoren.md)           |
+| 4.  | [Schleifen](./skript/schleifen.md)             |
+| 5.  | [Bedingungen](./skript/bedingungen.md)         |
+| 6.  | [Klassen](./skript/klassen.md)                 |
+| 7.  | [Methoden](./skript/methoden.md)               |
+| 8.  | [Fehlerbehandlung](./skript/exceptions.md)   |
+| 9.  | [Datenstrukturen](./skript/datenstrukturen.md) |
+| 10. | [Testen](./skript/tests.md)                    |
+
+## Live-Übungen
+Die Übungsaufgaben 
+
+| #   | Thema                     | Musterlösung                                     |
+| --- | ------------------------- | ------------------------------------------------ |
+| 1.  | [Operatoren][2]           | [Click me!](./live/solutions/operatoren.nim)  |
+| 2.  | [Bedingungen][3]          | [Click me!](./live/solutions/bedingungen.nim) |
+| 3.  | [Klassen und Methoden][4] | [Click me!](./live/solutions/klassen.nim)     |
+| 4.  | [Zusammenfassung][5]      | [Click me!](./live/solutions/recap.nim)       |
+
+
+## Links:
+- [Nim Download] (https://nim-lang.org/install.html)
+- [Online Compiler][1]
+
+
+
+[1]: https://www.jdoodle.com/execute-nim-online
+[2]: ./live/operatoren.md
+[3]: ./live/bedingungen.md
+[4]: ./live/klassen.md
+[5]: ./live/recap.md