po: write detailed specification of wished backlinks behaviour

Signed-off-by: intrigeri <intrigeri@boum.org>

1 files changed, 25 insertions, 5 deletions

diff --git a/doc/plugins/po.mdwn b/doc/plugins/po.mdwn
index 4262640bc..4f6212ff4 100644
--- a/doc/plugins/po.mdwn
+++ b/doc/plugins/po.mdwn
@@ -247,12 +247,32 @@ be fixed by something like [[todo/using_meta_titles_for_parentlinks]].
 
 ### backlinks
 
-`po_link_to = negotiated`: if a given translatable `sourcepage.mdwn`
-links to \[[destpage]], `sourcepage.LL.po` also link to \[[destpage]],
-and the latter has the master page *and* all its translations listed
-in the backlinks.
+#### `po_link_to = negotiated`
 
-`po_link_to = current`: seems to work nicely
+If a given translatable `sourcepage.mdwn` links to \[[destpage]],
+`sourcepage.LL.po` also link to \[[destpage]], and the latter has the
+master page *and* all its translations listed in the backlinks. On the
+other hand, translations of `destpage` get none of these backlinks.
+What would be nice is:
+
+- if a translatable page links to another translatable page: the
+  master destpage gets a backlink to the master sourcepage, and every
+  slave destpage gets a backlink to the corresponding slave sourcepage
+- if a translatable page links to a non-translatable page: the
+  destpage gets a backlink to the master sourcepage only
+- if a non-translatable page links to a translatable page: every
+  master or slave destpage gets a backlink to the sourcepage
+- if a non-translatable page links to another non-translatable page:
+  the default behavious is nice, don't change it
+
+#### `po_link_to = current`
+
+At first glance, backlinks seem to work nicely, but a more thorough
+look is needed.
+
+#### `po_link_to = default`
+
+FIXME
 
 Translation quality assurance
 -----------------------------