On Fri, 2007-04-20 at 23:13 +0100, Dimitris Glezos wrote:
> 2 - The same problem above happen on CVS Docs. We have the
msgid
> "translator-credits" in PO files, but it is't displayed on pages
> published at
docs.fedoraproject.org <
http://docs.fedoraproject.org>.
> However we have some confused things here, because some modules, like
> mirror-tutorial <
http://docs.fedoraproject.org/mirror/>, shows names of
> translators as author, cause they were added in rpm-info.xml in
> <colophon> tag. But, in other modules, like install-guide
> <
http://docs.fedoraproject.org/install-guide/fc6/>, this does't happened.
> Then... What's the right thing to do?
The right thing to do is have translators in "translator-credits" and create a
"colophon" section that prints out this string. We have two choices here, the
way I see it:
1. List all translators in all languages' documents. To do this, the author
should maintain a list of the translators in the POT file itself (see:
release-notes).
2. Each localized document lists its own translators. The msgid in the POT is
empty and each language fills in the PO its own translators.
Once we decide, we need to open bug reports for all affected docs (so that we
know what's fixed and what's not yet) and someone in the `cvsdocs` group could
go ahead right away and fix it.
I would like to see some XSLT to produce a special authorship page for
translators. The number of translators working on a document far, far
outnumber the number of authors, and putting all these names on the
front page makes the document more difficult to read. Readers will
likely skip the front material such as the first introductory section if
they can't see it quickly. I would propose that we move author, editor,
and translator names to this colophon area, linked prominently from the
front page with a name like "Contributor Credits." "Colophon" is
probably not right since that usually occurs at the end of a work, and I
would like to see this linked from the front.
The copyright for a work should generally be held by the author(s) only,
which might take some additional scut-work. I see some docs where we
have many names listed, including editors and translators.
--
Paul W. Frields, RHCE
http://paul.frields.org/
gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717
Fedora Project:
http://fedoraproject.org/wiki/PaulWFrields
irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug