More translations of the Advent Calendar

The response to the 2009 advent calendar has been amazing so far. One frequently asked question since then has been the need for more translations. Some people commented on my previous post about helping with the Polish and Portuguese translations, and some others sent me an email directly about the same topic.

But for obvious reasons, the "More with symfony" book is not yet available in the symfony repository, and as such, the translation in other languages cannot be finished before Christmas. Also, the advent calendar is not available in the repository neither for technical reasons. The symfony documentation will only host the final book which has a slightly different table of contents as the chapters are not splat into several parts (the book has "only" 15 chapters). For all these reasons, even the most motivated translators lack the infrastructure to do their jobs well... until now.

If you want to translate the "More with symfony" book in your language, here is what you need to do:

  • Be motivated: Translating 320 pages is huge amount of work, especially when you are not a professional translator (on average, you will need 2 to 4 hours to translate a chapter). So you definitely need some help. Start by looking for at least 3-4 motivated people willing to help with the translation (you can subscribe to the symfony doc mailing-list, and talk about your plan on the symfony user mailing-list). You need to find both translators and proof-readers.

  • Ask access to the repository: Write me (fabien.potencier [[at]] an email with the language you want to translate the book to, the full names, emails, and trac usernames of the team (more people will be able to join later on of course). You will then receive full instructions about how to translate the book, and where to commit your translations.

  • Begin the translation: Half-translated tutorials/books are less valuable. So, you must know that the book will only be made available when the whole translation is finished and proof-read.

  • Be Committed: Translating a book is not a one-shot effort. The English book will evolve in the coming months. Based on our readers feedback, we will fix typos, fix bugs in code examples, tweak the most obscure paragraphs, and some more. The best translation teams are committed to update the book on a regular basis to keep it up to date with the English version (The Italian, Spanish, and Japanese translation teams are a perfect example of such a great commitment).

Some practical notes about the translations:

  • You will obviously have access to the remaining chapters before they are published on the symfony website.

  • All translated chapters, as for the original ones, will be released under the Creative Commons Attribution-Share Alike 3.0 Unported License.

  • The book will be made available as a printed book like the English one.

  • Each translator will have about 100 words to talk about himself in the "About the Authors" section of the printed book. You will become famous!

  • All translators will receive a "free" printed book.

There is more than one way to contribute to an Open-Source project. You can write code, you can help people on the mailing-list, you can spread the word on your blog and forums, you can talk at conferences, you can write some tutorials, and of course, you can help translating the existing documentation.

That's a unique occasion for local symfony communities to speak out. I would love to turn over the pages of the Portuguese, German, Arabic, Hindi, Chinese, or Russian version of the "More with symfony" book. Remember, I love books, I want more of them!

Help the Symfony project!

As with any Open-Source project, contributing code or documentation is the most common way to help, but we also have a wide range of sponsoring opportunities.


PS: There is plenty of existing symfony documentation that has unfinished translations. Even when it seems that htey are finished they should be checked to be up2date:
Translating a whole chapter can be more longer as it takes between 5 or 6 hours according to its length for a beginner.

I commented in other topic and send you a direct email.
After send the comment, I see that the advent calendar aren't in svn. 'cause of that I send you a email.

We group four translators to pt_BR and we are ready to go
What about getting autographs from the core team on the book?
Sorry for double posting but I would be interested in helping you guys out on translating the book to pt_BR, Lucas.

Do you have any extra space left in the team for me to fill?

It looks like you guys don't have any e-mail thread on the documentation mailing list about it so I'm using the comments to get in touch.
@Daniel A. Tiecher
You're more than welcome to help.

We use our own group(symfony-pt in google groups) to coordinate translation.

Just register yourself in the group and stay in touch ;-)
Is already somebody working on the german translation? Fabian maybe?
I think I could help with the translation to portuguese... What do I have to do to sign for the team?
see "German Translation - Advent Calendar 2009"

@Maura Bouca
contact Lucas: "pt_br translate of advent_calendar"
Hello i m new here and i just want to know about translations of "Symphony" book.I found information here.Thank You.
That`s great.but is it possible to put the name of translator in the online version too?
The translation team for the Portuguese have a new group specifically for discussions about the translation.

If you are interested, please ask to join:
Need Help in Spanish Translation
Need Help in Spanish Translation???

Sorry for double posting

Comments are closed.

To ensure that comments stay relevant, they are closed for old posts.