From owner-freebsd-doc@freebsd.org Fri May 17 01:52:14 2019 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 90CFB15ACBEC for ; Fri, 17 May 2019 01:52:14 +0000 (UTC) (envelope-from ebrandi@fugspbr.org) Received: from mail-qk1-f195.google.com (mail-qk1-f195.google.com [209.85.222.195]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) server-signature RSA-PSS (4096 bits) client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 905F685BE3 for ; Fri, 17 May 2019 01:52:13 +0000 (UTC) (envelope-from ebrandi@fugspbr.org) Received: by mail-qk1-f195.google.com with SMTP id a132so3509102qkb.13 for ; Thu, 16 May 2019 18:52:13 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=zv1eo7We0BYVOgjpNtWVhR3Z8ety527aZS37zwrqDJ4=; b=YN46PXY3X4T47tqW9y/e2qRUOWT0VZEbUaCK2VAlYT7cPmso5BlNTkhOjZepQaDRcR 98VOmkoN+G2BuiCwB3Wg7cakE4FkOocwRATw1o38qk7m0yAW24uWVsZdC2rdAxa3yGVI eHw/4RK9xfcBV5GpX6XC5L6fWh5LFkpvfx3JfkMPPogmmV/YwM72uQ+6kLSJ7lW42eGA DIjC7g3SRBNi7GkQxOYjlqB3mVYBlgHeK0Q691R34zW38co/NDkiRmlsFk1knuDddBpV 1RimTaezQWrkdwGsI77fPt6qhZYyEIE1grnBnYVw9fNYbkv1CPpKcjrgVOY++arqt9a3 fP2A== X-Gm-Message-State: APjAAAUHMNzSoRRfLd909dNGwfMRikOXekaotWne2skOh9tgETQjJSOb yHfkdIZvnaC2fEKizZbeBSLhwxgyiJm8XJubQv0KnFhPL6dygQ== X-Google-Smtp-Source: APXvYqxWkpuiE6cTX4oRUdaCw+YnuKF0aQc8KkdKsQnD+TWo2XxytlLNMyw0+3DI+492sFQIJC3514l0g/TTmKWpcTU= X-Received: by 2002:a05:620a:131b:: with SMTP id o27mr14271377qkj.115.1558057474789; Thu, 16 May 2019 18:44:34 -0700 (PDT) MIME-Version: 1.0 From: Edson Brandi Date: Thu, 16 May 2019 22:44:23 -0300 Message-ID: Subject: Improving translation workflow for FreeBSD Documentation with Zanata To: freebsd-doc@freebsd.org Content-Type: text/plain; charset="UTF-8" X-Rspamd-Queue-Id: 905F685BE3 X-Spamd-Bar: -- Authentication-Results: mx1.freebsd.org X-Spamd-Result: default: False [-2.77 / 15.00]; ARC_NA(0.00)[]; NEURAL_HAM_MEDIUM(-0.98)[-0.981,0]; RCVD_COUNT_TWO(0.00)[2]; FROM_HAS_DN(0.00)[]; TO_MATCH_ENVRCPT_ALL(0.00)[]; NEURAL_HAM_LONG(-1.00)[-1.000,0]; MIME_GOOD(-0.10)[text/plain]; PREVIOUSLY_DELIVERED(0.00)[freebsd-doc@freebsd.org]; TO_DN_NONE(0.00)[]; AUTH_NA(1.00)[]; RCPT_COUNT_ONE(0.00)[1]; RCVD_TLS_LAST(0.00)[]; MX_GOOD(-0.01)[aspmx.l.google.com]; NEURAL_HAM_SHORT(-0.81)[-0.811,0]; RCVD_IN_DNSWL_NONE(0.00)[195.222.85.209.list.dnswl.org : 127.0.5.0]; R_SPF_NA(0.00)[]; FORGED_SENDER(0.30)[ebrandi@freebsd.org,ebrandi@fugspbr.org]; DMARC_NA(0.00)[freebsd.org]; RWL_MAILSPIKE_POSSIBLE(0.00)[195.222.85.209.rep.mailspike.net : 127.0.0.17]; R_DKIM_NA(0.00)[]; MIME_TRACE(0.00)[0:+]; ASN(0.00)[asn:15169, ipnet:209.85.128.0/17, country:US]; FROM_NEQ_ENVFROM(0.00)[ebrandi@freebsd.org,ebrandi@fugspbr.org]; IP_SCORE(-1.17)[ipnet: 209.85.128.0/17(-3.51), asn: 15169(-2.27), country: US(-0.06)]; TO_DOM_EQ_FROM_DOM(0.00)[] X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 17 May 2019 01:52:14 -0000 Hi Guys, This afternoon we had a working group here in Ottawa where I, dbaio and ygy presented the results that we have obtained over the last few months using Zanata as a working tool for translating the official FreeBSD documentation. The adoption of a web tool has helped us to achieve greater community engagement by making the translation process simple and easy for casual translators, since the only requirement to contribute to the translation effort was to have access to a web browser, and to have a few free minutes in the day or week to donate. In this last months we managed to get 35 articles and 5 books translated to pt_BR, including The FreeBSD Handbook (it was committed today morning to our SVN), until now we have received contributions from more than 40 volunteers, and new contributions still arriving for the remaining books :) The group of 2 volunteers that are working to translate the documentation to es_ES are using the same tools and workflow, and in the last 5 months of work, they have translated 18 articles. I have uploaded the presentation that we used in the WG to our wiki, and i invite you all to take a look: https://wiki.freebsd.org/DevSummit/201905/Zanata?action=AttachFile&do=view&target=Improving+translation+workflow+for+FreeBSD+Documentation+with+Zanata.pdf If someone is interested in replicating the workflow that we are using to start translating the documentation into some new language, we are willing to talk and help in whatever it takes to have it done. We have idle capacity on the server that we are using to host Zanata, and it will be a pleasure to create a project for you to test the tool, and the proposed workflow. For those who want to follow our steps, the best advice that we can give is: start with the smallest documents. It will be simpler and faster to see the results, and seeing the concrete result of your translation effort is essential in the beginning of this long journey so that you stay motivated and engaged ;) Thks and sorry for the text wall :| [ ]'s Brandi -- Edson Brandi ebrandi@FreeBSD.org OpenPGP Key: 0x209E9B54FFD3035B 443B 5363 564F 06C3 EA54 9482 209E 9B54 FFD3 035B