Bug#436162: developers-reference: Please document best practices for requesting translations and updates
Package: developers-reference
Version: 3.3.8
Severity: wishlist
Tags: patch
Hello,
It would be nice if section "8.2 I18N & L10N FAQ for maintainers" could
mention asking for a review on debian-l10n-english, and sending call for
translations on debian-i18n or asking for translation updates with
podebconf-report-po.
A patch is attached.
(It also changes DDTP to "Debian I18N" since the DDTP is only responsible
for the Debian Descriptions)
Thanks in advance,
--
Nekral
diff -rauN ../orig/developers-reference-3.3.8/developers-reference.sgml ./developers-reference-3.3.8/developers-reference.sgml
--- ../orig/developers-reference-3.3.8/developers-reference.sgml 2006-11-12 12:05:22.000000000 +0100
+++ ./developers-reference-3.3.8/developers-reference.sgml 2007-08-05 01:59:26.000000000 +0200
@@ -5428,7 +5439,7 @@
<sect1 id="l10n-faqm-tr">How to get a given text translated
<p>
To translate package descriptions or debconf templates, you have nothing to do;
-the DDTP infrastructure will dispatch the material to translate to volunteers
+the Debian I18N infrastructure will dispatch the material to translate to volunteers
with no need for interaction from your part.
<p>
For all other material (gettext files, man pages, or other documentation), the
@@ -5437,6 +5448,15 @@
subscribed to this list, and they will take care of the translation and of the
reviewing process. Once they are done, you will get your translated document from them
in your mailbox.
+ <p>
+<command>podebconf-report-po</command> (from the
+<package>po-debconf</package> package) permits to automate call for
+translation to the debian-i18n mailing list (using the
+<option>--call</option> option), for PO files (this is not restricted to debconf
+PO files).
+ <p>
+It is good practice to ask for a review of the document on the
+debian-l10n-english mailing list before sending call for translations.
<sect1 id="l10n-faqm-rev">How to get a given translation reviewed
<p>
@@ -5460,6 +5480,11 @@
translated document, stating that the translation is somehow outdated, and that
the reader should refer to the original document if possible.
<p>
+<command>podebconf-report-po</command> (from the
+<package>po-debconf</package> package) permits to automate requests for
+translation update, sent to the previous translators or translation
+mailing lists, for PO files (this is not restricted to debconf PO files).
+ <p>
Avoid removing a translation completely because it is outdated. Old
documentation is often better than no documentation at all for non-English
speakers.
Reply to: