diff --git a/docs/17-porting-tips.md b/docs/17-porting-tips.md
index e990176e..a66214ba 100644
--- a/docs/17-porting-tips.md
+++ b/docs/17-porting-tips.md
@@ -1,5 +1,6 @@
-# Porting tips
+# Tips for upgrading your configuration
 
+<a name="v4"></a>
 ## From 3.5 to 4.0
 
 The
@@ -8,7 +9,7 @@ you might have added to your `rc.lua`.
 This avoids most of the possible errors due to missing important changes.
 
 If you still wish to ignore this advice, first read the
-<a href="./89-NEWS.md.html">NEWS</a> section about the breaking changes. This
+<a href="89-NEWS.md.html#v4">NEWS</a> section about the breaking changes. This
 document assumes you did.
 
 Be warned, even if it looks like it's working after changing some lines, **it wont
diff --git a/docs/89-NEWS.md b/docs/89-NEWS.md
index 2d536718..6538f14d 100644
--- a/docs/89-NEWS.md
+++ b/docs/89-NEWS.md
@@ -1,5 +1,6 @@
 # NEWS
 
+<a name="v4"></a>
 # Awesome window manager framework version 4.0 changes
 
 <center> <img src="../images/AUTOGEN_wibox_logo_logo_and_name.svg" /> </center>
@@ -532,7 +533,8 @@ Many changes now cause a deprecation warning instead of breaking hard.
 However, it is important to take note of these changes in order to avoid new
 bugs.
 
-Also see the <a href="./17-porting-tips.md.html">porting tips</a>
+Also see the <a href="17-porting-tips.md.html#v4">tips for porting your
+configuration</a>.
 
 ### There can be off-screen clients unless rc.lua is adapted