symfony/symfony-docs — Issue #996: [i18n] How to make the whole docs easy to translate?
Author: hrbonz
Created: 2012-01-17 06:15:15+00:00
State: open

I am right now working in a Chinese company, I pushed the use of symfony2 to rebuild the website. Everybody is pretty happy with the choice but the documentation would need some translation. This brings me to the point. Has internationalization of the docs ever been discussed? I've seen several translation projects on github ([search for symfony-docs](https://github.com/search?langOverride=&q=symfony-docs&repo=&start_value=1&type=Repositories)) and especially several for the same language (two .fr, two .es, two .pl, three .jp, etc). Wouldn't it make sense to find a good way to have all the translations joined in a common effort?

Sphinx supports i18n (http://sphinx.pocoo.org/intl.html) through the use of so called `.po` files. The problem I see here is how to structure this so it does not become to be a huge headache for everybody. I'm still thinking about that part.

Opinions?