[zanata-devel] Issue 269 in flies: Story: As a project maintainer I would like to keep the history of previous translators that have worked on a PO file

[flies at googlecode.com]

Comment #4 on issue 269 by sean.flanigan: Story: As a project maintainer I  
would like to keep the history of previous translators that have worked on  
a PO file
http://code.google.com/p/flies/issues/detail?id=269

Pushing updates needs to be more complicated (again):

1. When pushing (importing) a brand-new document to Zanata:
  - Just import original comment verbatim as headerComment.
  - Translations are marked as "imported" (because real credits come from  
comment above).

2. When saving a translation entered through web interface:
  - Credit translation to current Zanata user.

3. When pushing (or importing) an updated document (even if there are no  
new translations)
  - If merging: line by line, compare imported comment to headerComment,  
append any new lines to headerComment.
  - If importing: replace old headerComment with new headerComment.
  - In both cases: Skip any lines which include #zanata.

4. When pulling (exporting) translations
  - Output comment as (headerComment + generatedComments).
  - generatedComments has one line per translator per year, skips imported  
translations:

# AUTHOR NAME <EMAIL at ADDRESS>, YEAR. #zanata


Why the change?  Merging must handle the possibility that two translators  
both push the same PO file around the same time.

1. Alice translates the PO file in Zanata.
   # Alice <alice at example.com>, 2011. #zanata
2. Bob pulls the PO file, as updated by Alice.
3. Charlie also pulls the PO file, as updated by Alice.
4. Bob adds a credit comment and some translations, pushes to Zanata.
   # Alice <alice at example.com>, 2011. #zanata
   # Bob <bob at example.com>, 2011.
4. Charlie also adds a credit comment and some translations, pushes to  
Zanata.
   # Alice <alice at example.com>, 2011. #zanata
   # Charlie <charlie at example.com>, 2011.

If "latest push wins", Charlie would erase Bob's credit from existence  
without even meaning to.