Gentoo Archives: gentoo-dev

From: Duncan <1i5t5.duncan@×××.net>
To: gentoo-dev@l.g.o
Subject: [gentoo-dev] Re: GLEP 42 (news) Round Seven
Date: Tue, 10 Jan 2006 18:29:22
Message-Id: pan.2006.01.10.18.13.49.700698@cox.net
In Reply to: [gentoo-dev] GLEP 42 (news) Round Seven by Ciaran McCreesh
1 Ciaran McCreesh posted <20060105151138.5baf5700@××××××××.home>, excerpted
2 below, on Thu, 05 Jan 2006 15:11:38 +0000:
3
4 > News Item Directories
5 > ---------------------
6 >
7 > Each news item will be represented by a directory whose name is the same
8 > as the news item's identifier.
9 >
10 > The directory will contain a file named
11 > ``yyyy-mm-dd-short-name.en.txt``, which contains the text of the news
12 > item, in English, in the format described below.
13 >
14 > If a news item is translated, other files named
15 > ``yyyy-mm-dd-short-name.xx.txt`` (where ``xx`` is the ISO 639
16 > [#iso-639]_ two letter country code) will also be provided. However,
17 > only the English version of a news item is authoritative. This
18 > anglocentricity is justified by precedent [#glep-34]_.
19
20 This needs date clarification. For the translation, is the translated
21 file to retain the date of the original, or get the date of the
22 translation?
23
24 > News Item Headers
25 > '''''''''''''''''
26 >
27 > The following headers describe the purpose and format of the news item:
28 >
29 [snip]
30 >
31 > ``Posted:``
32 > Date of posting, in ``yyyy-mm-dd`` format (e.g. 2005-12-18) for
33 > compatibility with GLEP 45 [#glep-45]_. Mandatory.
34
35 Similarly here. Are translated news items to retain the original date
36 header or change it as appropriate?
37
38 I'd suggest an additional "Translated:" date header. The original posted
39 header could then be retained, with the translated header reflecting the
40 translation date.
41
42 I'm not sure about the filename embedded date. As the original date is
43 also in the directory name, the translated item filename could be the
44 translated date. OTOH, if the news item including the date is considered
45 as a single unit, there could be some confusion if a news-item is referred
46 to by differing filenames other than the country-code portion,
47 particularly if the reference doesn't include the directory name (which is
48 of course the news-item ID, therefore avoiding the potential confusion).
49
50 In any case, both of these should be specified one way or the other in the
51 GLEP, avoiding confusion.
52
53 --
54 Duncan - List replies preferred. No HTML msgs.
55 "Every nonfree program has a lord, a master --
56 and if you use the program, he is your master." Richard Stallman in
57 http://www.linuxdevcenter.com/pub/a/linux/2004/12/22/rms_interview.html
58
59
60 --
61 gentoo-dev@g.o mailing list