From Fedora Project Wiki

Revision as of 17:09, 10 April 2016 by Jaaf64 (talk | contribs) (→‎FAQ)

This page is a work in progress. It has not been validated and and has to be considered has a basis for discussion between de Documentation Project and the translation teams.

The last updating of this page occurred on 04/10/2016. Nevertheless, it doesn't mean that the Translation State Table of the guides has been updated as well.

Purpose of this Page

This page aims at facilitating communication between the Documentation Project and the translations teams regarding the translation of the various guides on Zanata. Each team should make its own copy of the English page using the language bar mechanism, copy the page, and fill the parameters for their language thus allowing everybody to have an overview of the translation state and to get some guidance about what deserves translation and what doesn't.

When copying the English page, don't copy the FAQ. After copy add a FAQ specific to your language for internal questions and prepend it with the followin anchor: <span id="target-faq"></span>.

Translation State Table

For updating by guide owners, see Updating by Guide Owners

For updating by language teams, see Updating by Language Teams

A question? Before asking, please have a look at the "Guidance for translators" colums and at the FAQ

Add a link here on your language page to point to your own FAQ
Guide Title Priority Latest version on docs.fedoraproject.com Status on Zanata Guidance for translators
Owner
Updated
Repository
Zanata
Low
Médium
High
English
(above F20)
Target
Language
Branch Status RO Reason Translated
%
Approved
%
Click on the guide title to edit the template Update only on translated page
Accessibility Guide Not available Master Active
Sparks Pagure
04/10/2016 Zanata
Amateur-radio Guide Not available Master Active
jjmcd, Sparks Pagure
04/10/2016 Zanata
Anaconda Addon Development Guide Not available Master Active
Pagure
04/10/2016 Zanata
Fedora Election Guide Not available Master Active
Sparks Pagure
04/10/2016 Zanata
Fedora Packager's Guide Not available Master Read-only This guide is not being actively maintained.
pmkovar Pagure
04/10/2016 Zanata
Fedora Power Management Guide Not available Master Read-only This guide is not being actively maintained.
yruseva Pagure
04/10/2016 Zanata
Fedora Security Guide Not available Master Active
Sparks, kennepepe Pagure
04/10/2016 Zanata
Fedora Software Collections Guide Not available Master Read-only This guide is not being actively maintained.
pmkovar Pagure
04/10/2016 Zanata
Fedora SoftwareManagement Guide Not available Master Active
Gomix Pagure
04/10/2016 Zanata
Fedora Storage Administration Guide Not available Master Read-only This guide is not being actively maintained.
OPEN Pagure
04/10/2016 Zanata
Fedora EFI Secure Boot Guide Not available Master Active
Sparks [??]
04/10/2016 Zanata
Fedora Installation Guide F23 Edition 1 F23 Active
pbokoc Pagure
04/10/2016 Zanata
Fedora Virtualization Deployement and Adminstration Guide Not available Master Active
{{{owner}}} {{{repository}}}
04/10/2016 Zanata
FreeIPA Guide Not available Master Read-Only This guide is not being actively maintained.
{{{owner}}} {{{repository}}}
04/10/2016 Zanata
Musician Guide Not available Master Active
crantila Pagure
04/10/2016 Zanata
Networking Guide F23 (DRAFT) Master Active
StephenW Pagure
04/10/2016 Zanata
Fedora System Administrator's Guide F23(DRAFT) Master/F22/F21 Active
StephenW Pagure
04/10/2016 Zanata
Translation Quick Start Guide Not available Master Read-only This guide is not being actively maintained.
{{{owner}}} {{{repository}}}
04/10/2016 Zanata
Virtualization Getting Started Guide F23 Master Read-only
dmparker Pagure
04/10/2016 Zanata
Fedora OpenSSH Guide Not available Master Active
Pagure
04/10/2016 Zanata
Multiboot Guide F23 Master Active
chrisrobets Pagure
04/10/2016 Zanata
SELinux User and Administrator's Guide F22 Master Active
bancinco
04/10/2016 [Not on Zanata]

Updating by Guide Owners

Each line of the table is a template for the various languages. To edit this template, just click on the name (link) of the guide to go to the template page. Edit the template and fill the parameters of the Guidetrstat template as shown in this example :

{{Guidetrstat
|color=
|title=Accessibility Guide
|update={{REVISIONMONTH}}/{{REVISIONDAY}}/{{REVISIONYEAR}}
|zanata=Zanata
|priority=
|availabilityEn=Not available
|availabilityTr={{{availabilityTr|}}}
|branch=Master
|status=Active
|roreason=
|percenttr={{{percenttr|}}}|percentappr={{{percentappr|}}}
|trupdate={{{trupdate|}}}
|guidance=}}[[Template:{{PAGENAME}}/doc]]


Please give only values to the parameter of the Guidetrstat template (such as branch, green color) not to the parameters that make use of this templates' parameters (e.g. availabilityTr={{{availabilityTr}}})
  • Parameters available for changes:
    • color : To change the color of the whole line. Red for Read-only, magenta for guide not yet on Zanata.
    • priority : High, Medium"" or "Low"
    • availabilityEN : Version which is available en docs.fedoraproject.org or Not available
    • branch : A / separated list of the branches that are available for translation on Zanata (e.g.Master/F24/F23)
    • status : Active if translatable, Read-only if not translatable
    • roreason : why this guide is read-only on Zanata
    • guidance: When the situation is not obvious on Zanata, please give some guidance for translators
All the changes made here are for all the languages!

Updating by Translation Teams

Do not edit the English page
Translation teams should never edit the English page but their translated page instead

How to make changes is quite obvious. Hereafter is an example :

{{Guidetrstat/accessibility
|availabilityTr=Not available
|pertenttr=50%
|percentappr=0%
|trupdate= 7 avril 2016
}}

In the example above, the line for the Accessibility Guide has been changed. Changes concern only four parameters:

    • availibilityTR : Whether the translated guide is available on docs.fedoraproject.org or not. If yes, give the last version available, if not, just write Not available
    • percenttr: Give the percentage of translated messages
    • percentappr: Give the percentage of approved translated messages.
    • trupdate : Give the date of your update for this guide


FAQ

  • When there are several branches present on Zanata, which one to update?
* Answer:
  • When the latest version on Zanata refers to an English guide marked DRAFT, what to do?
* Answer:
  • When an English Guide is only visible on the web site for an earlier version(more than 1 version backward), what to do?
* Answer:

  • Should a Guide not available on the web site but present on Zanata only in a master branch be translated or not?
*Answer: