diff --git a/README.rst b/README.rst
index 2ac949707..f995a4599 100644
--- a/README.rst
+++ b/README.rst
@@ -7,7 +7,6 @@ BO4E
|PyPI pyversions|_
-
.. |PyPi| image:: https://img.shields.io/pypi/v/bo4e.svg
.. _PyPi: https://img.shields.io/pypi/v/bo4e
@@ -21,25 +20,31 @@ BO4E
.. _`PyPI pyversions`: https://pypi.python.org/pypi/bo4e/
+🇩🇪 Dies ist eine BO4E Referenz-Implementierung in Python.
+Gleichzeitig ist dieses Repository der Ort, um Fragen und Erweiterungen des BO4E-Standards zu diskutieren.
+
+🇬🇧 This is a Python library that implements Business Objects for Energy `BO4E `_.
+It requires Python >=3.8.
+
+Dokumentation / Fragen und Anregungen zum BO4E Datenmodell
+==========================================================
+Eine Dokumentation des Datenmodells und JSON Schemata zur Erzeugung von Beispieldaten finden sich auf `read the docs `_.
+Bei Fragen oder Anregungen, bitte `einfach ein Issue in diesem Repo aufmachen `_.
-Python Library that Implements `BO4E `_.
-Requires Python >=3.8.
+Code Beiträge
+=============
+Änderungsvorschläge (sowohl an das Datenmodell als auch an die Implementierung in Python) können direkt als Code in Form von Pull Requests eingereicht werden.
+Details dazu finden sich im `Contribution Guide`_.
-Other Noteworthy BO4E Implementations
-=====================================
+Andere nennenswerte BO4E Implementierungen
+==========================================
* `C#/.NET`_
* `Golang`_
* `Kotlin`_
* `TypeScript`_
-Code Beiträge
-============
-Änderungsvorschläge können direkt als Code in Form von Pull Requests eingereicht werden.
-Details dazu finden sich im `Contribution Guide`_.
-
-
Versioning
==========
| Short background information about versioning of python packages.