diff --git a/README.md b/README.md
index 6aaaeb3..e47237d 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,26 @@
-# Template repository to implement a Datashare Python worker
+<style>
+.md-content .md-typeset h1
+</style>
 
-[//]: # (TODO: write a full tutorial here)
-[//]: # (configuration, dependency injection, build etc etc)
+<p align="center">
+  <a href="https://datashare.icij.org/">
+    <img align="center" src="docs/assets/datashare-logo.svg" alt="Datashare" style="max-width: 60%">
+  </a>
+</p>
+<p align="center">
+    <em>Better analyze information, in all its forms</em>
+</p>
+<br/>
+
+---
+
+**Documentation**: <a href="https://icij.github.io/datashare-python" target="_blank">https://icij.github.io/datashare-python</a>
+
+---
+
+# Implement **your own Datashare tasks**, written in Python
+
+Most AI, Machine Learning, Data Engineering happens in Python.
+[Datashare](https://icij.gitbook.io/datashare) now lets you extend its backend with your own tasks implemented in Python.
+
+Turning your own ML pipelines into Datashare tasks is **very simple**, learn about it inside [documentation](https://icij.github.io/datashare-python).