[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#436162: developers-reference: Please document best practices for requesting translations and updates

Package: developers-reference
Version: 3.3.8
Severity: wishlist
Tags: patch


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

A patch is attached.

(It also changes DDTP to "Debian I18N" since the DDTP is only responsible
for the Debian Descriptions)

Thanks in advance,
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
 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.
 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
@@ -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. 
+<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

Reply to: