diff --git a/.readthedocs.yaml b/.readthedocs.yaml
index 5c7176e..aac26e7 100644
--- a/.readthedocs.yaml
+++ b/.readthedocs.yaml
@@ -5,6 +5,11 @@ build:
   tools:
     python: "mambaforge-22.9"
 
+python:
+  install:
+    - method: pip
+      path: .
+
 sphinx:
   builder: html
   configuration: docs/conf.py
diff --git a/README.md b/README.md
index cd6dcc3..1a2b14b 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,6 @@
+[![Documentation Status](https://readthedocs.org/projects/refl1d-models/badge/?version=latest)](https://refl1d-models.readthedocs.io/en/latest/?badge=latest)
+
+
 refl1d models
 =============
 
diff --git a/docs/index.rst b/docs/index.rst
index b3000f3..1b5768e 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,5 +1,5 @@
 =========================================
-Welcome to python project template docs!
+Refl1d example models
 =========================================
 
 .. toctree::