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.
