diff --git a/doc/plugins/po.mdwn b/doc/plugins/po.mdwn
index 04a45f8f2..125a9b016 100644
--- a/doc/plugins/po.mdwn
+++ b/doc/plugins/po.mdwn
@@ -466,6 +466,11 @@ gettext/po4a rough corners
 Better links
 ------------
 
+### Subpages
+
+On a translation page, links to subpages should actually be links to
+the master page's subpages. They currently appear as broken links.
+
 ### Page title in links
 
 To use the page titles set with the [[meta|plugins/meta]] plugin when