===== FreeBSD Developer Summit: Documentation Translation =====

Schedule: May 16th, 13:30-15:00 (Thursday)

Where: DMS 1130

Session chair: [[/EdsonBrandi|EdsonBrandi]] ''%%ebrandi@%%''

==== Overview ====

The purpose of this working group is to discuss the adoption of a web tool to facilitate the translation of official %%FreeBSD%% documentation into other languages.

We have obtained excellent results in using Zanata for translating documentation to pt_BR (and for some other languages), and we will introduce and discuss the difficulties we faced, the benefits to the volunteers productivity and the final results that we have obtained over the last months.

We will also discuss the use of automated translations by machine learning to generate the first drafts of the translated documents, the difficulties we faced, the pros and cons of this approach, and the results we have obtained.

To participate, please contact the working group chair [[/EdsonBrandi|EdsonBrandi]] ''%%ebrandi@%%'' and CC ''%%devsummit@%%''.

People who cannot attend in person might be able to participate through video conferencing or chat tools.

==== Goals ====

Present a translation workflow proposal using Zanata and expand the discussion about the possibility of deploying a Zanata server within the %%FreeBSD%% cluster infrastructure.

==== Topics ====

^ Topic ^
| Presentation of the Zanata use case by Doc-BR |
| Presentation of the py-transpopy use case by Doc-BR |
| Discuss the requirements for deploying a Zanata server |
| Discuss the options to manage access permissions on zanata |
| Discuss the rules to add a new language to Zanata |
| Discuss the rules to update Zanata templates |
| Discuss the rules about when a document will be considered ready to be committed |
| Discuss the best practices for recruiting volunteers for the translation projects |

==== Attending ====

To attend, you must register for the [[/DevSummit|developer summit]] as well as by email for this working group and be confirmed by the working group organizer.  Follow the guidelines described on the [[DevSummit/201905|main page]] or what you received by email.  Please contact the session chair with any questions.

**Please DO add yourself here and email the session chair if you plan to attend.**

^ # ^ Name ^ Username / Affiliation ^ Topics of Interest ^ Notes ^
| 1 | [[/EdsonBrandi|EdsonBrandi]] | ebrandi | * | Session chair |
| 2 | [[/DaniloBaio|DaniloBaio]] | dbaio |  |  |
| 3 | [[/GuangyuanYang|GuangyuanYang]] | ygy |  |  |
| 4 | [[/LiWenHsu|LiWenHsu]] | lwhsu |  |  |
| 5 | [[/WarrenBlock|WarrenBlock]] | wblock |  |  |

==== Results ====

{{devsummit/201905/zanata/improving_translation_workflow_for_freebsd_documentation_with_zanata.pdf?linkonly|Work Group Slides}}

----

{{tag>Docs}}