Monday, May 9, 2011

Why do you have to go and make things so complicated?

Remember, localizers are usually volunteers. When I started Narro, my idea was to make their life easier by allowing them to receive translations from anyone and to pull/push translations without knowing SVN, Mercurial, or any other technical stuff.

The idea setup would be:
  1. The localizer gets the translation files through Narro import
  2. Translation begins (offline or online)
  3. The localizer pushes the translation files through Narro export
And no, it's not that I'd like to introduce a new tool instead of running svn commit, it's just that I'd like to spare people of the nightmares of merging and maintaining branches when all they want to do is translate.

The current Mozilla setup is:
  1. Pull the entire Mozilla repository (> 500MB)
  2. Scan its directory for localization files and build through symlinks a folder structure that resembles the one that localizers need to push in their repository
  3. Run an import from that folder
  4. Translation begins
  5. Translation is exported in XPI format for testing purposes
  6. There's a script made by Axel Hecht, compare-locales that does some checks for validity, because translations can really break the product. To help, I'm running that after every export and post a link to a diff file that contains links to the texts that need fixing
  7. Translation is exported in the structure that should be comitted to Mercurial
  8. The localizer needs to have Mercurial through SSH with key authentication set up
  9. The localizer commits the structure exported from Narro (hg pull .../xx-XX.zip && unzip xx-XX.zip && hg commit && hg push)
  10. The localizer checks the tinderbox for any build failures
  11. The localizer checks the dashboard for any problems detected by compare-locales
  12. The localizer does a signoff (pushes a button for the revision he wants to release) in the dashboard

I may have forgotten some steps, but obviously this is not the perfect setup. I'm keen on helping making things easier as I'm a localizer myself but there are some blockers here:
  1. I can commit via Narro, but that causes problems because several localizers commit with the same account. I can't let localizers commit with their credentials because that would mean uploading their private SSH key and that defeats the purpose of a SSH key. From my experience, getting rid of that is a real advantage as you often want to fix only a few strings while you're on the road and don't feel like hg pull, hg commit, hg push or don't have Mercurial installed or your SSH key set up.
  2. I don't have access only to the localization files. I have to pull the entire repository.
  3. To build a language pack I need the whole repository.
Oh, there are the web pages as well. Fortunately I'm close to handling those in Narro as well.

Now don't think that Mozilla is the only software that has this complicated setup. But this localizer tool should be able to cope even with this situation, because it's not a perfect world we live in. It's a challenge.