diff --git a/doc/kwindecoration/button.png b/doc/kwindecoration/button.png
index a4b78f0d6c..e744ea478b 100644
Binary files a/doc/kwindecoration/button.png and b/doc/kwindecoration/button.png differ
diff --git a/doc/kwindecoration/configure.png b/doc/kwindecoration/configure.png
index 4b13fb6e2a..d68764b4ad 100644
Binary files a/doc/kwindecoration/configure.png and b/doc/kwindecoration/configure.png differ
diff --git a/doc/kwindecoration/decoration.png b/doc/kwindecoration/decoration.png
index a6b8bd134b..80530cc2e2 100644
Binary files a/doc/kwindecoration/decoration.png and b/doc/kwindecoration/decoration.png differ
diff --git a/doc/kwindecoration/index.docbook b/doc/kwindecoration/index.docbook
index 5dd97576fe..0f2992be23 100644
--- a/doc/kwindecoration/index.docbook
+++ b/doc/kwindecoration/index.docbook
@@ -13,8 +13,8 @@
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
 </authorgroup>
 
-<date>2016-04-14</date>
-<releaseinfo>Plasma 5.6</releaseinfo>
+<date>2018-03-18</date>
+<releaseinfo>Plasma 5.12</releaseinfo>
 
 <keywordset>
 <keyword>KDE</keyword>
@@ -64,12 +64,12 @@ edges.</para>
 <para>You are encouraged to experiment with the different styles until
 you find one which best suits your pattern of work.</para>
 
-<para>In the preview pane at the right of each style you find a <inlinemediaobject><imageobject>
+<para>In the preview of each style you find a <inlinemediaobject><imageobject>
 <imagedata fileref="configure.png" format="PNG"/></imageobject></inlinemediaobject> 
 configure button to open configuration dialogs for the decoration.</para>
 
 <para>The options in this configuration dialog are applied to all windows. 
-Some window decorations (&eg; <quote>Breeze</quote> or <quote>Oxygen</quote>)
+Some window decorations (&eg; <quote>Breeze</quote>)
 provide a <guilabel>Window-Specific Overrides</guilabel> tab.
 On this tab you can change the border size and the visibility 
 of the window titlebar for particular windows.</para>
@@ -114,7 +114,8 @@ The available options depend on the selected style.
 <title>Buttons</title>
 
 <para>This tab allows you to customize the button location on the titlebar. 
-You can drag buttons into the titlebar, remove them or drag around the
+You can drag buttons &eg; the <guilabel>Application menu</guilabel> into the 
+titlebar, remove them or drag around the
 buttons until you have the order that makes you comfortable.
 </para>
 
diff --git a/doc/kwindecoration/main.png b/doc/kwindecoration/main.png
index 319d6ed18f..55f6fb1d7e 100644
Binary files a/doc/kwindecoration/main.png and b/doc/kwindecoration/main.png differ