FreeBSD Developer Summit: Documentation Translation

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

Where: DMS 1130

Session chair: 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 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 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 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

ebrandi

*

Session chair

2

DaniloBaio

dbaio

3

GuangyuanYang

ygy

4

LiWenHsu

lwhsu

5

WarrenBlock

wblock

Results

DevSummit/201905/Zanata (last edited 2019-05-16 19:18:02 by EdsonBrandi)