[prev in list] [next in list] [prev in thread] [next in thread] 

List:       fedora-docs-list
Subject:    Re: xrefs and AsciiBinder
From:       Shaun McCance <shaunm () gnome ! org>
Date:       2017-11-27 15:55:54
Message-ID: 1511798154.26828.58.camel () gnome ! org
[Download RAW message or body]

On Mon, 2017-11-27 at 15:45 +0100, Jean-Baptiste Holcroft wrote:
> Le 23/11/2017 à 14:32, Brian Exelbierd a écrit :
> > What do you think?
> 
> If the link uses titles, which are translatable, it may lead to
> document 
> breakage for localized content.

Shouldn't we use the block IDs above the headers? Example:

  [[ch-Working_with_Kernel_Modules]]
  = Working with Kernel Modules

  Go read xref:ch-Working_with_Kernel_Modules.

We can leave this ID stable even when the title is translated. This
could also get rid of the problem of slashes in titles. We could just
decide that we don't put the slash in the ID even if it's in the title.

  [[Doing_Stuff_with_IO]]
  = Doing Stuff with I/O

--
Shaun
_______________________________________________
docs mailing list -- docs@lists.fedoraproject.org
To unsubscribe send an email to docs-leave@lists.fedoraproject.org

[prev in list] [next in list] [prev in thread] [next in thread]