List Archive: gentoo-doc
Note: Due to technical difficulties, the Archives are currently not up to date.
provides an alternative service for most mailing lists.c.f. bug 424647
Alexey Chumakov wrote:
> After some extensive work with mostly outdated Russian docs, I tend to
> agree with Jan--we need some means to signal an outdated translation.
> My proposition is somewhat simpler --
> 1. Let the reader decide if the document is outdated :-)
> We'll need to link the derived document to source one, and add a
> displayed message:
> "Source document is available at [link]
> [optional version - fetched from source doc if possible
> [optional date]"
> Attr might look like this:
> <guide link="/doc/ru/sample.xml" lang="ru" source-link="/doc/en/sample.xml">
> Or, maybe it'll be possible to fetch dependency info from metadoc...
Well, I asked about something similar (maybe completely different - I
don't know XSLT much) - use <uri link="metadoc:file-id"> and
automatically select translated file if available. I was told that it is
not easy and (iirc) can't be done ATM. Would be great, though :-).
> 2. It's also useful to introduce some link like "send comments here..."
> directly into document, and point it to GDP [internalization] page in
> the document's language.
> E.g. many Russian readers do not realize easily where to post their bug
> reports and suggestions...
IMHO useless, but I'm not typical Russian reader :-)
> 3. For unofficial languages, IMHO there is no need to do anything if
> there's no index reference to it.
Well, but what if previously supported language transformes into
unsupported one? There will be some links from non-official websites
pointing to the outdated translations...
> And 3rd party articles are already marked :-)
IIRC, articles themselves are *not* marked, only the index is.
cd /local/pub && more beer > /dev/mouth