What's right about translation credits?

[Dimitris Glezos]

O/H Diego Búrigo Zacarão έγραψε:
> Hello, all..
> 
> I have some doubts about translation credits and I hope that someone can
> explain it to me.
> 
> 1 - About msgid "translator-credits" in all PO files. I suppose we must
> put one translator per line, in the form of:
> NAME <EMAIL>, YEAR. (right?)
> So, where that will appear? I have checked some modules GUI like
> system-config-* and I did't see it anywhere.

I'm glad you brought this up Diego. We've discussed it in the past (also in
FOSDEM with some other translators) and everyone agrees that it is a good thing
to give credit to Authors and Translators. FWIW, all GNOME apps have this in the
"Help -> About" menu.

Concerning Fedora applications we need to:

  1. Open bug reports for apps that don't give credits to translators (and
authors) as a part of their GUI.

  2. Some apps don't even have a "translator-credits" msgid in their POT, so
mention this in those bug reports as well.

We need a volunteer to do this. Diego, how about giving it a try? :)

Someone from us could even grab the source of some apps and produce patches on
the bug reports; the chances to achieve what we want increase dramatically.

> 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.

-d


-- 
Dimitris Glezos
Jabber ID: glezos at jabber.org, GPG: 0xA5A04C3B
http://dimitris.glezos.com/

"He who gives up functionality for ease of use
loses both and deserves neither." (Anonymous)
--