Ciaran McCreesh posted <[EMAIL PROTECTED]>, excerpted
below,  on Thu, 05 Jan 2006 15:11:38 +0000:

> News Item Directories
> ---------------------
> 
> Each news item will be represented by a directory whose name is the same
> as the news item's identifier.
> 
> The directory will contain a file named
> ``yyyy-mm-dd-short-name.en.txt``, which contains the text of the news
> item, in English, in the format described below.
> 
> If a news item is translated, other files named
> ``yyyy-mm-dd-short-name.xx.txt`` (where ``xx`` is the ISO 639
> [#iso-639]_ two letter country code) will also be provided. However,
> only the English version of a news item is authoritative. This
> anglocentricity is justified by precedent [#glep-34]_.

This needs date clarification.  For the translation, is the translated
file to retain the date of the original, or get the date of the
translation?
 
> News Item Headers
> '''''''''''''''''
> 
> The following headers describe the purpose and format of the news item:
> 
[snip]
> 
> ``Posted:``
>     Date of posting, in ``yyyy-mm-dd`` format (e.g. 2005-12-18) for
>     compatibility with GLEP 45 [#glep-45]_. Mandatory.

Similarly here.  Are translated news items to retain the original date
header or change it as appropriate?

I'd suggest an additional "Translated:" date header.  The original posted
header could then be retained, with the translated header reflecting the
translation date.

I'm not sure about the filename embedded date.  As the original date is
also in the directory name, the translated item filename could be the
translated date.  OTOH, if the news item including the date is considered
as a single unit, there could be some confusion if a news-item is referred
to by differing filenames other than the country-code portion,
particularly if the reference doesn't include the directory name (which is
of course the news-item ID, therefore avoiding the potential confusion).

In any case, both of these should be specified one way or the other in the
GLEP, avoiding confusion.

-- 
Duncan - List replies preferred.   No HTML msgs.
"Every nonfree program has a lord, a master --
and if you use the program, he is your master."  Richard Stallman in
http://www.linuxdevcenter.com/pub/a/linux/2004/12/22/rms_interview.html


-- 
gentoo-dev@gentoo.org mailing list

Reply via email to