Debian Installer developers are strongly encouraged to read the po-debconf(7) man page and must have a good knowledge of po-debconf mechanisms. Please ask for advice on the <debian-boot@lists.debian.org> mailing list when in doubt.

Templates files must be named <package>.templates. Developer should not use files named debian/templates, even though debhelper scripts properly handle such files. This requirement has been added because the translators work on a general file which groups together all templates from all Debian Installer packages. This general file mentions, for each string, the originating file name. If this file name contains the package name, the translator will then know which package the string (s)he translates belongs to.

Maintainers must respect the Debconf Templates Style Guide (DTSG) (see the section General recommendations for authors and translators of the Debian Developers Reference). In any case, before committing new templates or templates changes, these templates must have been reviewed by other Debian Installer developers or an internationalisation (i18n) coordinator.

Committing templates with incorrect English or templates with a different writing style than the general Debian Installer writing style could trigger nearly immediate translation work. These translations will later need to be adapted again when the strings are corrected.

For that reason, new templates for an existing Debian Installer package should initially be marked as non translatable. This is done by not prepending the templates fields with an underscore character. Example:

Template: debian-installer/foo/bar
Type: note
Description: New note.
 This is a completely new note, added for package foo.
  

Packages which are newly added to Debian Installer can ignore this. Their templates may be marked as translatable, because these packages are ignored by the synchronisation script until they are added to the packages/po/packages_list file (see Section 6.5, “Translation synchronisation”).

After adding the new templates or the new package, maintainers must request for peer review on <debian-boot@lists.debian.org>.

New packages will be added to the master files only when this review has been completed.

Strings which need translation must be prepended by a leading underscore (_) character in the templates file after the strings review:

Template: debian-installer/foo/bar
Type: note
_Description: New note
 This is a completely new note, added for package foo.
  

Then, the synchronisation script will automatically add the two new strings to the translators files, allowing them to work on translations.