diff --git a/doc/theme3/convert.md b/doc/theme3/convert.md
new file mode 100644
index 00000000..7689057f
--- /dev/null
+++ b/doc/theme3/convert.md
@@ -0,0 +1,17 @@
+# Convert old themes to the new format
+
+**Rofi** 1.4 can still read in and convert the old theme format. To read the old format, convert it, and dump it into a
+new file run:
+
+```bash
+rofi -config {old theme} -dump-theme > new_theme.rasi
+```
+
+This gives a very basic theme, with the colors from the old theme.
+You can preview the theme using:
+
+```bash
+rofi -theme new_theme.rasi -show run
+```
+
+
diff --git a/doc/theme3/index.md b/doc/theme3/index.md
new file mode 100644
index 00000000..af9b52d8
--- /dev/null
+++ b/doc/theme3/index.md
@@ -0,0 +1,7 @@
+# Rofi Advanced Style Information
+
+**rasi** is **rofi**'s new theme format (theme format version 3).
+
+* [Specification](specification.md)
+* [Tutorial](tutorial.md)
+* [Covert old themes](convert.md)
diff --git a/doc/rofi-theme3-empty.png b/doc/theme3/rofi-theme3-empty.png
similarity index 100%
rename from doc/rofi-theme3-empty.png
rename to doc/theme3/rofi-theme3-empty.png
diff --git a/doc/rofi-theme3-extend-colors.png b/doc/theme3/rofi-theme3-extend-colors.png
similarity index 100%
rename from doc/rofi-theme3-extend-colors.png
rename to doc/theme3/rofi-theme3-extend-colors.png
diff --git a/doc/rofi-theme3-extend-selected.png b/doc/theme3/rofi-theme3-extend-selected.png
similarity index 100%
rename from doc/rofi-theme3-extend-selected.png
rename to doc/theme3/rofi-theme3-extend-selected.png
diff --git a/doc/rofi-theme3-extend.png b/doc/theme3/rofi-theme3-extend.png
similarity index 100%
rename from doc/rofi-theme3-extend.png
rename to doc/theme3/rofi-theme3-extend.png
diff --git a/doc/rofi-theme3-global.png b/doc/theme3/rofi-theme3-global.png
similarity index 100%
rename from doc/rofi-theme3-global.png
rename to doc/theme3/rofi-theme3-global.png
diff --git a/doc/rofi-theme3-padbor-box.png b/doc/theme3/rofi-theme3-padbor-box.png
similarity index 100%
rename from doc/rofi-theme3-padbor-box.png
rename to doc/theme3/rofi-theme3-padbor-box.png
diff --git a/doc/rofi-theme3-padbor.png b/doc/theme3/rofi-theme3-padbor.png
similarity index 100%
rename from doc/rofi-theme3-padbor.png
rename to doc/theme3/rofi-theme3-padbor.png
diff --git a/doc/rofi-theme3-transparent-fixed.png b/doc/theme3/rofi-theme3-transparent-fixed.png
similarity index 100%
rename from doc/rofi-theme3-transparent-fixed.png
rename to doc/theme3/rofi-theme3-transparent-fixed.png
diff --git a/doc/rofi-theme3-transparent.png b/doc/theme3/rofi-theme3-transparent.png
similarity index 100%
rename from doc/rofi-theme3-transparent.png
rename to doc/theme3/rofi-theme3-transparent.png
diff --git a/doc/themer.md b/doc/theme3/specification.md
similarity index 100%
rename from doc/themer.md
rename to doc/theme3/specification.md
diff --git a/doc/theme3-tutorial.md b/doc/theme3/tutorial.md
similarity index 100%
rename from doc/theme3-tutorial.md
rename to doc/theme3/tutorial.md