I saw the Translations of package descriptions video from FOSDEM 2010. Every distribution has two translatable string for each package: a synopsis (summary, short description) and a long description. These descriptions differ from distribution to distribution. The descriptions should be shared between the distributions. This will enable us to share the translations of the descriptions.
My idea: Why not letting upstream provide the package description and the translation for it? They should have the knowledge to provide a good description and to update it if required. To encourage upstream to provide the description, we should create a freedesktop specification for it. Quick draft: The tarball should contain a file named package.info. The package.info file should contain three RFC-2822-like fields for each package: Package, Synopsis, and Description. Translation can be stored in package.info.<language> (for example package.info.de).
Example package.info:
Package: audacity
Synopsis: A fast, cross-platform audio editor
Description: Audacity is a multi-track audio editor for Linux/Unix,
MacOS and Windows. It is designed for easy recording, playing
and editing of digital audio. Audacity features digital effects and
spectrum analysis tools. Editing is very fast and provides unlimited
undo/redo.
.
Supported file formats include Ogg Vorbis, MP2, MP3, WAV, AIFF, and AU.
What do you think about this idea?
Edit: Alexandre Franke found an existing markup language designed for our use case: Description of a Project (DOAP). Package is name there, synopsis is shortdesc, and description is description. Here is my example in DOAP:
<Project xmlns="http://usefulinc.com/ns/doap#"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:foaf="http://xmlns.com/foaf/0.1/">
<name>Audacity</name>
<shortdesc xml:lang="en">
A fast, cross-platform audio editor
</shortdesc>
<description xml:lang="en">
Audacity is a multi-track audio editor for Linux/Unix,
MacOS and Windows. It is designed for easy recording, playing
and editing of digital audio. Audacity features digital effects and
spectrum analysis tools. Editing is very fast and provides unlimited
undo/redo.
Supported file formats include Ogg Vorbis, MP2, MP3, WAV, AIFF, and AU.
</description>
</Project>