1 |
pclouds wrote: |
2 |
> Hi, |
3 |
> While translating documents, i found that several documents have not |
4 |
> updated to reflect current packages in portage (sorry i forgot most of |
5 |
> them). |
6 |
|
7 |
That's not very helpful then. |
8 |
If you find that a doc that needs to be fixed, it needs to be fixed, as simple |
9 |
as that. Please file a bug, a patch, send a mail, whatever. |
10 |
|
11 |
> I would like to suggest making a link between a document and |
12 |
> relevant packages. Then we could encourage devs to check these |
13 |
> documents when they update packages and suggest doc team to fix docs. |
14 |
> It'd also be useful for users if we publish these info on |
15 |
> packages.g.o, show links to documents revelant to packages. |
16 |
> These info could be stored in package's metadata.xml (for example |
17 |
> alsa* package's metadata.xml would have a link to alsa-guide.xml). |
18 |
> Category's metadata.xml could be used too (for example, |
19 |
> sys-kernel/metadata.xml should contain a link to kernel-guide.xml, |
20 |
> this document need to be updated really, gentoo-dev-sources have died |
21 |
> for months and should be removed from the doc). |
22 |
> I'd like to know doc team's comment first before post it to |
23 |
> gentoo-dev. Any comment? |
24 |
|
25 |
Adding a <doc> tag to metadata.xml has been discussed recently on -dev. |
26 |
Once the guys in charge of metadata.xml have implemented support for it, and |
27 |
once the devs have added the info to their packages' metadata.xml, and once |
28 |
the guys in charge of p.g.o use it, it will magically work. |
29 |
None of that is in the hands of GDP. |
30 |
|
31 |
|
32 |
Cheers, |
33 |
-- |
34 |
/ Xavier Neys |
35 |
\_ Gentoo Documentation Project |
36 |
/ French & Internationalisation Lead |
37 |
\ http://www.gentoo.org/doc/en |
38 |
/\ |
39 |
-- |
40 |
gentoo-doc@g.o mailing list |