1 |
Jan Kundrát wrote: |
2 |
> Xavier Neys wrote: |
3 |
> |
4 |
>>>a) "This article is not part of the official Gentoo documentation, it |
5 |
>>>has been republished on our site only for your convenience and with |
6 |
>>>permisson of the respective copyright owner. It may not reflect current |
7 |
>>>state of things and could be outdated." |
8 |
>> |
9 |
>>No need to hack the xsl for that, just add it at the beginning of each |
10 |
>>article like we already have the note about owners. |
11 |
> |
12 |
> This implies manual changing of several files which is not good, IMHO. |
13 |
|
14 |
Why? We change a small number of docs once, then forget about them. |
15 |
Do you think it is better to introduce more code, more complexity to be |
16 |
maintained, more stuff to be executed on each and every doc request? |
17 |
Is that your definition of better? |
18 |
|
19 |
>>Can only be done with a reliable document location made available to the |
20 |
>>xsl which we lack at the moment. |
21 |
>> |
22 |
>>I wish we could but at the moment, we can't really |
23 |
> |
24 |
> Well, I think that fixing <guide path="..."> that does'nt contain |
25 |
> directory name is easier than adding some disclaimer to every file and |
26 |
> could be done by a script (haven't tried, though). And it wouldn't |
27 |
> matter if we didn't catch every outdated/unmaintained/... document, but |
28 |
> at least some of them will be marked. |
29 |
|
30 |
If we mark some files as unmaintained, we're also telling our users that |
31 |
non-marked files *are* maintained. |
32 |
|
33 |
> So, is there any problem to check the value of the path attribute |
34 |
> (provided it includes the directory name) against some regexp and if it |
35 |
> matches, add some warning to the generated page? |
36 |
> |
37 |
> Maybe also introduce another parameter to metadoc saying "this |
38 |
> translation is outdated", but I'm not sure if this is worth the effort. |
39 |
|
40 |
You should try to think about feasibility, implementation & consequences first. |
41 |
|
42 |
|
43 |
/me comes back on Monday. |
44 |
Have a nice weekend, |
45 |
-- |
46 |
/ Xavier Neys |
47 |
\_ Gentoo Documentation Project |
48 |
/ French & Internationalisation Lead |
49 |
\ http://www.gentoo.org/doc/en |
50 |
/\ |
51 |
|
52 |
|
53 |
-- |
54 |
gentoo-doc@g.o mailing list |