diff --git a/docs/index.rst b/docs/index.rst
index 8b46d87b55c23bf854929cab5c31dcd003adc343..b95b28547f98fbb0c91952cdf2effd47706eefa7 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -17,3 +17,4 @@ panel](https://open.greenhost.net/stackspin/user-panel).
    usage
    helmchart
    local_development
+   local_dev_remote_kratos
diff --git a/docs/local_dev_remote_kratos.md b/docs/local_dev_remote_kratos.md
index 9bf9b0856262a4d55eba31b15a3ea27cdb374789..e14f4a5c72333455f15b25c7ea8f83382058f8c0 100644
--- a/docs/local_dev_remote_kratos.md
+++ b/docs/local_dev_remote_kratos.md
@@ -1,6 +1,4 @@
-
-
-# Introduction
+# Local dev with Kratos
 
 The main role for this repo is provide Single-Sign-On. The architecture to make
 this happen has a lot of moving components. A quick overview:
@@ -33,7 +31,7 @@ this happen has a lot of moving components. A quick overview:
    database server. There is once instance, with three databases. As all
    databases are very small this will not lead to resource limitation problems.
 
-# Installation
+## Installation
 
 The current login panel is not yet installed available in released  versions 
 of Stackspin. However, this does not prevent us from developing already on the
@@ -213,7 +211,7 @@ cd helmchart/single-sign-on
 helm upgrade -f /to/a/path/my_cluster_values.yaml single-sign-on . -n stackspin --debug
 ```
 
-# Development
+## Development
 
 1. Setup port redirects
 
@@ -337,7 +335,7 @@ And now it is time to start the app:
 
 If this starts smoothly, you should be ready to go.
 
-# Test you setup
+## Test you setup
 
 Hydra and kratos are now configured to redirect to localhost when they receive a
 request. So to test the setup, you simple can go to one of your application (for