diff --git a/kallithea/i18n/how_to b/docs/dev/i18n.rst
rename from kallithea/i18n/how_to
rename to docs/dev/i18n.rst
--- a/kallithea/i18n/how_to
+++ b/docs/dev/i18n.rst
@@ -1,3 +1,5 @@
+.. _translations:
+
 ============
 Translations
 ============
diff --git a/docs/dev/translation.rst b/docs/dev/translation.rst
deleted file mode 100644
--- a/docs/dev/translation.rst
+++ /dev/null
@@ -1,2 +0,0 @@
-.. _translations:
-.. include:: ./../../kallithea/i18n/how_to
diff --git a/docs/index.rst b/docs/index.rst
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -74,7 +74,7 @@ Developer guide
    :maxdepth: 1
 
    contributing
-   dev/translation
+   dev/i18n
    dev/dbmigrations