The big story for our Klocwork Insight 9.6 release was localization for our Japanese market. Prior to this effort, we provided a Japanese version that included a translation of a small portion of the documentation set.
Since we’re magnanimous, we felt that others should benefit from our suffering lessons learned from this endeavor. Originally, I’d hoped to do a video for this entitled Crying While Localizing in homage to that fun meme Crying While Eating. But asking one’s colleagues to blubber on camera for minutes at a time while confiding their frustrations was a little too much to expect.
First up in our three-part series is one-half of our technical writing team, Kevin. Kevin came our way through a co-op placement and has settled in nicely–that is, until he was tasked with liaising and troubleshooting duties related to translation. He’s in therapy now, but he’s doing OK.
As part of his healing process, he has agreed to share some of his pain points, knowing they may help others going through the same thing. On the plus side, perhaps someone out there could provide helpful suggestions.
1. The biggest challenge – Churn and re-translation
Problem: Material often had to be re-translated when new features affected pre-existing, already-translated UI strings and documentation. With a language like Japanese where formatting and punctuation are handled differently (for example, there’s no spacing between words, except in some instances, and bold and italics are indicated with square brackets) it was very difficult to tell where a re-translated sentence or paragraph belonged. This is what made it necessary to send entire pages out for re-translation and editing.
Solution: A freeze on development after a certain point would be helpful, but wouldn’t solve this problem entirely.
2. Help tool limitations – Page IDs and Media Wiki
Problem: We use MediaWiki for our documentation. Pages sent out for translation were exported to XML and then re-imported when translated. Any pre-existing pages had distinct page IDs. When the translated materials was re-imported, the pages were assigned new IDs. This was a problem for a number of pages that feed into context-sensitive help. New page IDs would break the local help. Old pages had to be deleted and the original Page ID had to be assigned to the translated page.
Solution: We’re looking into it. Instituting DITA and new tools is a pricey proposition.
3. Keeping track of strings
Problem: How to maintain a master list containing all of the latest, correct translation of UI strings. Translated and implemented UI strings were reviewed by our Japanese partners for accuracy. Translations were fixed in the tool, but not updated in a master list. So when questions arose about which version of the string was used, there was no place to check for the latest version, except to troll through problem reports or email threads. Very painful.
Solution: Buckle down, do the grunt work and update that Excel spreadsheet as changes are suggested and made.
The next installments will feature lessons learned from our lead tester and one of our developers. Stay tuned.